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TECHNICAL FIELD 



20 



Embodiments of this invention relate to automatically upgrading software. 



BACKGROUND AND SUMMARY 



i 



Automatic upgrade utilities are known in the prior art. However, prior art 
automatic upgrade utilities are not known to have provided firmware upgrades across an 
entire product line for units comprised of a plethora of different characteristics. In addition, 



prior art on automatic upgrade utilities are not known to operate across any network 
transports. Prior art on automatic upgrade utilities have rarely operated in the automatic 
data collection ("ADC") device platform environment. 

Many suppliers customize their products according to customer 
5 requirements. This is especially true with regard to products related to automatic data 
collection ("ADC"). Accordingly, the precise characteristics of the products sold by the 
supplier, even within a single product line, vary greatly. In the prior art, upgrades required 
a confusing disk swapping process and/or a direct serial connection to the device that 
required considerable user attention to ensure the upgrade completed successfully. 

10 Upgrades frequently consumed several hours, as each detail of the product being upgraded 
had to be painstakingly checked and disks constantly swapped. Moreover, an operator 
needed to be present to swap the diskettes. The presence of the operator often meant that 
during business hours the ADC device platform was unavailable for data collection while 
an upgrade was being accomplished. Many users were extremely reluctant to perform the 

15 installation procedure themselves because they were afraid of making mistakes and they 
were also concerned that they did not possess the requisite technical understanding to 
complete the process successfully. 

The following summary lists the issues resolved by implementing the 
automated upgrade process: 

20 o Reduce the downtime of the device due to an upgrade being performed 
o Reduce inputs required from the user to eliminate operator error 
o Reduce the time required to perform an upgrade, reduce manpower required 
© Increase the odds of having the upgrade process conclude successfully 
o Allow for scheduling of the upgrade during off-hours 

25 o Initiate simultaneous upgrades to multiple target devices 

o Allow for grouping of devices to reduce redundant operations 

© Perform the upgrade over a network to many devices as well as over a serial connection 

to a single device 
© Allow for upgrades to occur from remote, centralized locations 
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o Support differing scopes of upgrades via the same utility, i.e. install a patch versus 

install a new version of the operating system 
o Provide a single utility that can perform upgrades of a device's operating system, 
firmware, application and data files. 
5 The automated software upgrade utility allows a customer, product supplier 

or software vendor to upgrade the operating system, firmware, applications and data files 
on any product regardless of the product type and characteristics. This upgrade process can 
be invoked from a remote location or via interaction directly with the target device. 

The automated upgrade process is independent of the device hardware 
10 platform, operating system, the network transport utilized by the device, and the target 
device itself. 

The automated software upgrade process also allows for modification of the 
hardware configuration of the target device, e.g., change and reformat a hard drive 
partition. 

15 The automated upgrade utility may reside at remote sites, such as the user's 

place of business, and periodically query the product supplier for firmware upgrades. 

Alternatively, the upgrade utility may reside with the product supplier and periodically 

locate remote products and perform the upgrade process. 

In both configurations, the software upgrade utility retains the ability to 
20 identify all pertinent product characteristics, freeing the developer of the firmware upgrade 

from concerns regarding installing the upgrade across a wide range of product 

characteristics and nearly endless possible configurations. 

BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is a block diagram illustrating a suitable environment for aspects of 

25 the invention. 

Figure 2 is an example screen display of an example System Maintenance 

Menu. 

Figure 3 is an example screen display of a source inquiry dialog box. 
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Figure 4 is an example screen display of a minor upgrade confirmation 

dialog box. 

Figure 5 is an example screen display of a major D upgrade confirmation 

dialog box. 

5 Figure 6 is an example screen display of a major C upgrade confirmation 

dialog box. 

Figure 7 is an example screen display of a severe upgrade confirmation 

dialog box. 

DETAILED DESCRIPTION 

10 The automated software upgrade utility enables a product supplier or 

software vendor to remotely upgrade the firmware on any of its products, such as automatic 
data collection ("ADC") device platforms, regardless of product type or product 
characteristics. The upgrade utility may reside at remote sites, such as the product owner's 
place of business, and periodically query the product provider for firmware upgrades. 

15 Alternatively, the upgrade utility may reside with the product provider and periodically 
locate products at a product owner's facility and perform the upgrade process. In both 
configurations, the software upgrade utility retains the ability to identify all pertinent 
product characteristics, freeing the developer of the firmware upgrade from concerns 
regarding installing the upgrade across a wide range of products, each having nearly endless 

20 possible configurations. The invention is applicable for both ADC device platforms, ADC 
servers, and associated devices such as printers and radios. 

Upgrades may be classified from minor to severe. The minor upgrades are 
typically small software patches that have been determined not to pose a serious problem to 
other functionality. In contrast, severe upgrades constitute functionality that must be 

25 carefully provided to the product so as not disrupt the product or its functionality. 

The Product Supplier or Software Vendor publishes a software update, i.e., 
patch, upgrade or new release. The published releases can either be pushed down to the 
software upgrade server or they can be pulled from the published location. 
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Once the software upgrade utility has received the published release, it can 
be distributed in one of four methods. The first being, the software upgrade utility can act 
as a publishing location for other software upgrade servers, i.e., push the software release to 
other software upgrade servers or allow them to pull the latest software releases from the 
5 master software upgrade server. 

The second method is to schedule jobs within the software upgrade utility to 
push the software release to the target device(s), data collection devices registered in IDRS, 
at the requested time. 

The third method involves when devices initially register with IDRS for the 
10 first time. If IDRS is configured such that a specific configuration must exist on the device, 
and software is a component of that standard configuration, then the designated files are 
automatically transmitted to the target device. 

The fourth method involves a device that has an outdated version of the 
software resident. Upon startup of the device a check is done to ensure that the correct 
15 version(s) of the applicable software is resident, if not the device initiates the request for 
the upgrade to be initiated. 

Following are the functional requirements for the automated upgrade utility: 

• Allow upgrades or replacement of a device's operating system, firmware, application 
and data files from a single utility. 

20 • Allow for scheduling of upgrades to occur at designated scheduled times or initiated 
manually at any time. 

• Allow for devices to be organized into logical groups to allow for a single event to 
initiate upgrades for multiple devices. 

• Allow for the upgrades to be performed via a remote, centralized location as well as 
25 from the location where the devices are physically located. 

• The upgrade process must be independent of the transport network that the device is 
attached to. 

• The upgrade process must support both devices that exist on wired networks as well as 
wireless networks. 



[IIOII 8 265/SU)03713772.DOC] 



-5- 



o The upgrade process itself must not involve any user involvement once it has been 
initiated. 

o Software to be upgraded can originate from any location, i.e. CD-ROM, telnet to the 
hard disk of system running the upgrade process, retrieved from a web site or bulletin 
5 board, etc. 

o If the nature of the upgrade requires the hardware configuration of the target device to 
change, then this must not require user intervention. It must be fully automated as well. 
An example is changing the size of the hard disk partitions or changing the operating 
system. After the upgrade is completed, the device must be returned back to a fully 
10 functional state such that it can be used in a production environment. All configuration 

parameters and applications must be restored to allow this to happen. 

Figure 1 illustrates a server 100 having a firmware upgrade utility 101. The 
server 100 may be operated by the producer of ADC device platform, for example. The 
firmware upgrade utility 101 utilizes a transportation network 102 to reach a host 103. The 
15 firmware upgrade utility 101 may perform its operations using any transportation network 
102. The host 103 may comprise a centralized computing facility for a purchaser of the 
ADC device platforms products, for example. The host 103 in turn communicates with one 
or more controllers 104 over a transportation network 107 that in turn communicate with 
one or more ADC device platforms 105 over a transportation network 108. Each controller 
20 104 typically communicates with one or more ADC device platforms 105. The firmware 
upgrade utility 101 may also perform its operations using any transportation network 107 
and any transportation network 108. 

The upgrade utility 101 determines whether the upgrade concerns the 
controllers 104 and/or the ADC device platforms 105. The upgrade utility 101 locates the 
25 communications procedure for communicating with the host 103, the controllers 104, and if 
necessary with the ADC device platforms 105. The upgrade utility 101 then contacts the 
host 103 and uses resources on the host 103 to communicate with the controllers 104. For 
example, the host 103 may identify the type of the transportation network 107 to the 
upgrade utility 101. The upgrade utility 101 examines the controller 104 for its 
30 characteristics pertinent to the upgrade. Alternatively, the upgrade utility 101 may consult 
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a database 106 that contains the characteristics of the controllers 104 and the ADC device 
platforms 105. The upgrade utility 101 then locates the appropriate upgrade, determines 
how to proceed with the upgrade given the controller's characteristics, and provides the 
controller 104 with the necessary upgrade. If the upgrade also applies to the ADC device 

5 platforms 105, then the upgrade utility 101 examines the ADC device platform 105 for its 
characteristics pertinent to the upgrade. Alternatively, the upgrade utility 101 may consult 
the database 106 for pertinent ADC device platform characteristics. The upgrade utility 
101 then locates the appropriate upgrade, determines how to proceed with the upgrade 
given the ADC device platform's characteristics, and provides the ADC device platform 

10 105 with the necessary upgrade. Finally, the upgrade utility 101 ensures that the controllers 
104 and the ADC device platforms are returned to the same state they were in prior to the 
upgrade. 
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1.1. DCS Upgrade Utility 

1.1.1. Purpose and use of feature 

The DCS Upgrade Utility is a tool to manage the distribution of upgrade files placed on 
the Data Collection Server 300 (DCS 300). The DCS upgrade utility will allow the 
5 upgrade process to be started from the DCS 300, or from the ESD tool. The ESD tool can 
be at a remote site (remotely) or on the target DCS 300 (locally). The DCS upgrade utility 
will eliminate diskette swapping and prompting. 

BIOS upgrades will continue to be accomplished by diskette. 

10 

There are four classifications of upgrades: Minor, Reboot, Shutdown, and Severe. A 
minor upgrade does not require rebooting or shutting processes down. A major C upgrade 
requires the DCS 300 to reboot. A major D upgrade requires some processes like data 
collection to shutdown. When the upgrade is finished, the stopped processes will be 
15 restarted. A severe upgrade is an upgrade that requires changing partition sizes and/or 
changing operating systems. This also requires the DCS 300 to reboot. If a severe upgrade 
is necessary, it will require an upgrade CD-ROM in the CD-ROM drive. 

1.1.2. Results of feature usage 

Previous upgrades required disk swapping and considerable user input. Sometimes the 
20 upgrade took hours. An operator needed to be present to swap diskettes. This usually 
meant that during business hours the controller was unavailable for data collection while 
an upgrade was being accomplished. 

With the DCS Upgrade Utility in conjunction with the ESD tool, a DCS 300 software 
25 upgrade can be scheduled for an inactive time and doesn't require that an operator be 
present when the upgrade is being accomplished. The amount of time an upgrade takes to 
perform is also reduced. 
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Initiating an upgrade, from the System Maintenance Menu at the DCS 300, by selecting 
DCS Upgrade Utility, also requires little attention. Just start the upgrade and walk away. 

1 .1 .3. Feature Options 

The upgrade can be started remotely or at a DCS 300 using the ESD tool. A start time can 
5 be chosen so the upgrade doesn't interfere with data collection. The upgrade can also be 
started from the System Maintenance Menu at the DCS 300 by selecting DCS Upgrade 
Utility. 

1.1.4. Assumptions 

To use the DCS Upgrade Utility, the DCS software must be at 300 ver 1.0 or greater. Or, 
10 To use the DCS Upgrade Utility, the controller must be at 0200 ver 3.0 and have the DCS 
Upgrade Utility installed. In this case, if the upgrade is started from the controller, 
"g:\upgrade\upgrade" must be entered at the command line. The DCS Upgrade Utility can 
be installed from ESD or from a diskette. 



15 The upgrade files can be transferred over to the DCS 300 by ESD, or FTP without the use 
of a CD-ROM. The upgrade files can be transferred from an Intermec Web page to a DCS 
300 with ESD. Or, the upgrade files can be transferred from an Intermec Web page to a 
PC. Then, ESD or FTP in the binary mode can transfer the files to the DCS 300. If the 
upgrade files are to reside on the DCS 300, up to 120 MegaBytes must be available on 

20 drive d: of the hard drive depending on the size of the upgrade files. 

An upgrade CD-ROM must be in the CD-ROM drive or these files need to be present in 
the d:\upgrade directory to start the upgrade: 



25 FILE WHEN THE NEW FILE IS COPIED 

upgrade.exe only when the file changes 

*.zip every upgrade 
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If a CD-ROM is used in the upgrade of an 0200 controller , the user will need to enable 
the parallel port in the BIOS at the beginning of the upgrade and disable the parallel port 
in the BIOS at the end of the upgrade. The DCS 0300 comes with a CD-ROM drive 
installed and no BIOS changes are necessary. 

5 1.1.5. Interfaces to initiate or exercise the feature 

1.1.5.1. Making upgrade files available to the DCS 0300 

For each upgrade, new upgrade files will need to be made available to the DCS 300 before 
the upgrade is initiated. There are several methods to make the files available. The user 
can place a CD-ROM in the CD-ROM drive, or the user can put the files in the d:\upgrade 
10 directory with ESD or FTP. There are different ways to make the files available because 
some users do not have the capability to utilize TCPMP and won't be able to use ESD 
remotely or won't be able to use FTP. 

1.1.5.1. -11.1.5.1.1.1.1. CD ROM 

When using a CD-ROM the user will place an Upgrade CD-ROM in the CD-ROM drive 
15 and initiate the upgrade from the System Maintenance Menu or from ESD (remotely of 
locally). 

1.1.5.1.2. ESD Tool 

When using the ESD tool remotely, the user will download a file ( e.g. 300Vl_0.zip) from 
an Intermec Web page to a PC. The ESD tool will unzip the file in a directory. The ESD 
20 tool will copy the upgrade files to the d:\upgrade directory on the target DCS 300. The user 
will then schedule the upgrade using the ESD tool. ESD will initiate the upgrade remotely 
at the appropriate time. To use this method, the target DCS 300 must have a LAN card 
installed with IP enabled. 

25 Alternately, the user can put an upgrade CD-ROM in the CD-ROM drive at the target DCS 
300 and schedule the upgrade from ESD (locally or remotely). 

1.1.5.1.3. FTP 
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When using FTP, the user will download a file ( e.g. 300Vl_0.zip) from an Intermec Web 
page to a PC. The user will unzip the file in a directory. The user will login into the DCS 
300 using FTP and set the binary mode. The user will change directories to d:\upgrade. 
Then, the user will copy all the files to the DCS 300. To use this method, the target DCS 
5 300 must have a LAN card installed with IP enabled. 



The upgrade can then be started at the DCS 300, from the System Maintenance Menu, or by 
ESD (remotely or locally). 

1 .1 .5.2. Starting the DCS Upgrade Utility 

10 An upgrade can be initiated from ESD remotely or locally or the upgrade can be started 
from the DCS 300 System maintenance menu. 

See the ESD section for more information on initiating an upgrade from ESD. 

15 Referring to Figure 2, T to initiate an upgrade from the DCS 300, select DCS Upgrade 
Utility from the System Maintenance Menu. 



I 


| System Maintenance | 


-■-Make a selection from the list: 






[Configure Download Server 






Reset to Factory Defaults 
Back up System Files 
Restore System Files 
Terminal License Upgrade 
Screen Mapping License Upgrade 
Send Transactions 




Receive Transactions 

Firmware Upgrade Utility 

Install Accessories 

Start Host Session 

Terminal Password Configuration 

Controller Command Prompt 

Upqrade Utility 












Start Close || Help | 
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When DCS Upgrade Utility has been selected a box will show that asks the source of the 
upgrade files. Figure 3 is an example screen display of a source inquiry dialog box. 
Referring to Figure 3, A after the source of the upgrade files has been entered a menu will 
come up and ask if the user wants to start the upgrade or cancel. Pressing start will initiate 
5 the upgrade. Pressing cancel with end the upgrade. 
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Prompt for source of upgrad e files: 



DCS Upgrade Utility 



Where are the upgrade files?- 
0 CD-ROM 
G d.\upgrade 



OK 



Cancel 



10 



Different upgrades will cause the DCS Upgrade Utility to present different confirmation 
dialog boxes to allow the user to have a last chance to cancel the upgrade. Figures 4-7 
illustrate different dialog boxes that the DCS Upgrade Utility displays dependent upon the 
severity of the upgrade. Once a Start button has been pressed on any of the dialogs of 
Figures 4-7, the upgrade cannot be stopped. 
For a minor upgrade, this last chance box will be di s played: 



DCS Upqrade Utili 



The upgrade can be completed without 
affecting operation of the Data Collection 
Server. 



© 



Do you wish to start the 
Upgrade? 



| jtartj ] | Cancel! Hel P 



For a major D: upgrade, this last chance box will be displayed: 



15 
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WARNING: The upgrade will stop data 
collection if it is running. If data collection 
was stopped, it will be restarted when the 
upgrade is finished. Select cancel to end 
the upgrade/ : r _^_ l_ ; 



y^f Upgrade? 



fi\ Do you wish to start the 
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For a major C: upgrade, this last chanc e box will be displayed: 



DCS Upgrade Utility 



WARNING: First, data collection will be stopped (if running). 

Then, the controller will be shut down in an orderly 
manner. Check the box below for all configuration 
changes to be saved and activated during shutdown. 

[jjj Save and activate changes. 



0 



Do you wish to start the 
Upgrade? 



Start 



Cancel 



Help 



For a s evere upgrad e , this last chanc e box will b e displayed: 



DCS Upgrade Utility 



WARNING: All user files will be lost in the upgrade. You 
should copy all your user files to another disk 
before you continue the upgrade. 

Also , data collection will be stopped (if running). 
Then, the controller will be shut down in an orderly 
manner. Check the box below for all configuration 



chang e s to b e sav e d and act i vated dur i ng shutdown. 



0 



Hi Save and activate changes. 

Do you wish to start the 
Upgrade? 



Start 



Cancel 



Help 



10 



Once Start button has b e en pre s sed on any of the abov e mention e d dialogs, 
the upgrade cannot be s topped. 
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1.1.5.3. Upgrade Behavior 

When the upgrade is started, a file, upgrade.ini, is extracted from the zipped up files. This 
file contains the parameters of the upgrade, the software version of the upgrade, and a 
version controller. 

5 

The version controller is a list of versions of DCS 300 software that can be upgraded to its 
upgrade software version. The DCS 300's software version is compared to the version 
controller. If the DCS 300's software version is in the list, then the upgrade will proceed. 
A readme.doc can be found in the same directory as the upgrade files ( d:\upgrade or CD- 
10 ROM). The readme.doc file contains information on what versions of DCS 300 software 
the upgrade files can upgrade. 



The parameter list in the upgrade.ini file controls the upgrade behavior. It controls if the 
DCS 300 needs to reboot, shut down various DCS 300 processes, or proceed as is. The 
15 rebooting and process control is done automatically and requires no user input. 

1 . 1 .5.4. User Interface 

A user at the DCS 300 during an upgrade will see various messages at a command prompt 
window on the DCS 300 screen depending on the size of the upgrade. 



20 If the upgrade is a severe upgrade, the DCS 300 will reboot to an alternate operating 
system. These are the messages that can show on the screen based on additional 
upgrade.ini parameters: 

o Backing up system files 

25 o Deleting partitions 

o Creating partitions 

o Formatting partitions 

o Restoring system files 

© Checking video drivers 
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• Restoring configuration 



In addition to these messages, the user will see a list of files being copied to the appropriate 
directories after the partitions are formatted. 

If the upgrade is a major C upgrade, the DCS 300 will reboot to an alternate operating 
system. These are the messages that can show on the screen based on additional 
upgrade.ini parameters: 

• Backing up system files 

• Restoring system files 

• Checking video drivers 

• Restoring configuration 

In addition to these messages, the user will see a list of files being copied to the appropriate 
directories after the system files are backed up. 

If the upgrade is a major D upgrade, these are the messages that can show on command 
prompt window on the DCS 300 screen: 

• stopping data collection 

• starting data collection 

• shutting down the DCS 300 GUI 

• starting the DCS 300 GUI 

In addition to these messages, the user will see a list of files being copied to the appropriate 
directories after the processes have been shut down. 

If the upgrade is a minor upgrade, then all the user will see is a list of files being copied to 
the appropriate directories. 
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The ESD tool can also inquire the version of the upgrade software on the DCS 300 and the 
version of the DCS 300 software to make sure the upgrade will proceed normally. 

5 The DCS upgrade Utility will behave the same when the operating system is ported to 
Windows NT in a future release of the DCS 300. 
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1.2. DCS Upgrade Utility 

Currently a new upgrade kit is developed for each release. The latest was on CD- 
ROM. Previous upgrade kits were on diskette and took a long time to install. 

5 

With the DCS Upgrade Utility, changes to the C: drive will be zipped up into a file 
called os_drive.zip. Changes to the D: drive drive will be zipped up into a file called 
nextgen.zip. And, changes to the F: drive will be zipped up into a file called boot.zip. 
The upgrade files will either be and placed in the D:\upgrade directory with the ESD 

10 tool, from CD-ROM, or with FTP if the upgrade is ran from the d:\upgrade drive. If 

the upgrade is ran from the CD-ROM, the zip files will need to be on the CD-ROM. 
The upgrade can then be initiated by selecting DCS Upgrade Utility from the System 
Maintenance Menu, scheduled and initiated by ESD, or from the command line. The 
DCS Upgrade Utility will allow zipped-up files, on CD-ROM or placed in the 

15 d:\upgrade, to be exploded into the appropriate directories. 

1.2.1. Making the zip files 

One zip file for each drive will be needed. The zip file will be made with the use of a 
batch file. The batch file will contain all the names and directories of the files that need to 
20 be updated. A typical command in the batch file to zip a single file is "zip -a os _drive.zip 
c:\ibmcom\l el OOt.rsp". This line adds (-a) c:\ibmcom\lel00t.rsp to the zip file 
os_drive.zip. To zip the entire ibmcom directory, use this command: "zip -a -r -S 
os_drive.zip c:\ibmcom". Because the files that need updated are different for each 
upgrade, new zip files will be needed for each 

25 

The same upgrade.ini needs to be zipped up in every zip file. For REBOOT and SEVERE 
upgrades a list of backup files (upgdbkup.lst) will also need to be zipped up in the zip 
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files. This upgrade.ini is used to verify that the zip file is valid. These are the valid zip file 
names: 



o os_drive.zip - These are changes to the c: drive which contains the 
5 main operating system. 

o nextgen.zip - These are changes to the d: drive which contains the 
DCS software. The changes to the upgrade.exe should not be in 
here unless the upgrade is SEVERE. This is because the 
upgrade.exe on the d:\upgrade directory will be running if the 
10 upgrade was initiated from the d:\upgrade drive. 

o boot.zip - These are changes to the f: drive which is the alternate 
operating system used by SEVERE and REBOOT upgrades. 

1.2.2. Upgrade Files 

This is what the directory structure should look like on the CD-ROM and in the d:\upgrade 
1 5 directory: 



Volume in drive D is UNOVA 
Volume Serial Number is D0AD-8D81 



20 Directory of D:(OR G:)\UPGRADE\ 



01/01/01 12:00a <DIR> 

01/01/01 12:00a <DIR> 

12/08/97 01:17p 83,418,895 OS_DRIVE.ZIP 

25 12/08/97 01:21p 12,131,654 NEXTGEN.ZIP 

12/08/97 01:21p 12,131,654 BOOT.ZIP 

12/08/97 01:21p 12,131,654 UPGRADE.EXE 

09/04/97 08:31a <DIR> SVGA 

09/04/97 08:31a <DIR> VGA 
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09/04/97 08:31a <DIR> TOOLS 
7 File(s) 95,550,549 bytes 



Directory of D:(OR G:)\UPGRADE\SVGA 



10 



09/04/97 08:31a 

01/01/01 12:00a 

01/22/94 11:29a 

04/08/94 11:29a 

11/30/93 11:29a 

04/09/94 11:29a 
4 File(s) 



<DIR> 
<DIR> 

23,840 BVHSVGA.DLL 
123,645 IBMDEV32.DLL 
38,704 IBMVGA32.DLL 
77,436 VSVGA.SYS 
250,549 bytes 



Directory of D:(OR G:)\UPGRADE\VGA 



15 09/04/97 08:31a 

01/01/01 12:00a 

08/12/96 11:29a 

08/04/96 11:29a 

07/16/96 11:29a 

20 08/29/96 11:29a 
4 File(s) 



<DIR> 

<DIR> 

32,750 BVHSVGA.DLL 
82,891 IBMDEV32.DLL 
34,439 IBMVGA32.DLL 
147,965 VSVGA.SYS 
250,549 bytes 



Directory of D:(OR G:)\UPGRADE\TOOLS 

25 09/04/97 08:31a <DIR> 

01/01/01 12:00a <DIR> 

07/10/97 11:29a 2,149 CARD.IRQ 

06/05/97 01:58p 138,291 UNZIP.EXE 

8 File(s) 233,628 bytes 

30 
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Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG 





09/04/97 


08:31a 


<DIR> 






09/04/97 


08:31a 


<DIR> 


•• 


5 


09/04/97 


08:31a 


<DIR> 


IE 




09/04/97 


08:31a 


<DIR> 


1E100 




09/04/97 


08:31a 


<DIR> 


1E10OE 




09/04/97 


08:31a 


<DIR> 


1E100ET 




09/04/97 


08:31a 


<DIR> 


1E100T 


10 


09/04/97 


08:31a 


<DIR> 


1E1T 




09/04/97 


08:31a 


<DIR> 


IT 




09/04/97 


08:31a 


<DIR> 


2E 




09/04/97 


08:31a 


<DIR> 


2E100 




09/04/97 


08:31a 


<DIR> 


2E100T 


15 


09/04/97 


08:31a 


<DIR> 


2E1T 




09/04/97 


08:31a 


<DIR> 


LAN_LESS 




09/04/97 


08:31a 


<DIR> 


LIC_STRT 




09/04/97 


08:31a 


<DIR> 


ONERF 




07/19/96 


03:34p 




37 STARTUP.CM 


20 


09/04/97 


08:31a 


<DIR> 


TWORF 




09/04/97 


08:31a 


<DIR> 


TAXCM2 




1 


9File(s) 


37 bytes 



25 



Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\lE 



09/04/97 08:31a 
09/04/97 08:31a 
06/04/97 08:30a 
3 File(s) 



<DIR> 
<DIR> 

761 PROTOCOL.INI 
761 bytes 



30 
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Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\1E100 



09/04/97 08:31a <DIR> 

09/04/97 08:31a <DIR> 
5 04/30/97 11:15a 786PROTOCOL.INI 
3 File(s) 786 bytes 

Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\1E100E 

10 09/04/97 08:31a <DIR> 

09/04/97 08:31a <DIR> 
06/02/97 02:35p 983 PROTOCOL.INI 

3 File(s) 983 bytes 

1 5 Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\l E 1 00ET 

09/04/97 08:31a <DIR> 

09/04/97 08:31a <DIR> 

06/02/97 02:22p 1,367 PROTOCOL.INI 

20 3 File(s) 1,367 bytes 

Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\1E100T 

09/04/97 08:31a <DIR> 

25 09/04/97 08:31a <DIR> 

04/30/97 11:17a 1,160 PROTOCOL.INI 

3File(s) 1,160 bytes 

Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\lElT 

30 
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09/04/97 08:31a <DIR> 
09/04/97 08:31a <DIR> 
06/04/97 08:31a 1,134 PROTOCOL.[Nl 

3 File(s) 1,134 bytes 

5 

Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\lT 

09/04/97 08:31a <DIR> 

09/04/97 08:31a <DIR> 
10 05/01/96 02:07p 938 PROTOCOL.INI 

3 File(s) 938 bytes 

Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\2E 

15 09/04/97 08:31a <DIR> 

09/04/97 08:31a <DIR> 
06/04/97 08:31a 962PROTOCOL.INI 
3 File(s) 962 bytes 

20 Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\2El 00 

09/04/97 08:31a <DIR> 

09/04/97 08:31a <DIR> 

04/30/97 11:18a 1,013 PROTOCOL.INI 

25 3 File(s) 1,013 bytes 

Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\2E100T 

09/04/97 08:31a <DIR> 
30 09/04/97 08:31a <DIR> 
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04/30/97 11:19a 1,393 PROTOCOL.INI 

3 File(s) 1,393 bytes 



Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\2ElT 



09/04/97 08:31a 
09/04/97 08:31a 
06/04/97 08:31a 
3 File(s) 



<DIR> 
<DIR> 

1,342 PROTOCOL.INI 
1 ,342 bytes 



10 



Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\LAN_LESS 



09/04/97 08:31a 
09/04/97 08:31a 
15 02/28/96 11:54a 
10/02/95 10:25a 
02/28/96 11:54a 
5 File(s) 



<DIR> 
<DIR> 

216NGSETUP.CMD 
627 PROTOCOL.INI 
1,509 TCPSTART.CMD 
2,352 bytes 



20 Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\LIC_STRT 



09/04/97 08:31a 
09/04/97 08:31a 
04/04/96 07:41a 

25 02/08/96 03:13p 
02/08/96 03:15p 
06/20/96 12:54p 
04/04/96 07:42a 
02/08/96 03:14p 

30 03/21/97 07:38a 
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<DIR> 
<DIR> 

17 DCMF1.LIC 
17 DCMF2.LIC 
17 DCMF3.LIC 
17 DCML1.LIC 
17 DCML2.LIC 
17 DCML3.LIC 
1,271 NGSYS.BAK 



06/26/97 12:54p 
02/08/96 03:14p 
02/08/96 03:15p 
12 File(s) 



1,256 NGSYS.INI 
17NOLIMIT.LIC 
17NOLIMITF.LIC 
2,663 bytes 



Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\ONE_RF 



10 



09/04/97 08:31a <DIR> 

09/04/97 08:31a <DIR> 
06/02/97 02:07p 388 NET.CFG 

3 File(s) 388 bytes 



Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\TWO_RF 



15 09/04/97 08:31a 
09/04/97 08:31a 
06/02/97 02:08p 
3 File(s) 



<DIR> 
<DIR> 

217 NET.CFG 
217 bytes 



20 Directory of D:(OR G:)\UPGRADE\TOOLS\CONFIG\T_AX_CM2 



09/04/97 08:31a 

09/04/97 08:31a 

11/01/95 04:43p 

25 11/01/95 04:43p 

11/01/95 04:43p 

11/01/95 04:43p 
6 File(s) 



<DIR> 
<DIR> 

4,841 TWAX_CM2.CF2 
28,928 TWAX_CM2.CFG 
2,782 TWAX_CM2.NDF 
325 TWAX_CM2.SEC 
36,876 bytes 



30 



Total Files Listed: 



[1 1011 8 26SA16 8 959_I.DOC] 



126 File(s) 96,573,903 bytes 



If an upgrade is to be performed from the d:\upgrade drive, and changes to this directory 
5 tree should be copied over before upgrade begins. 

1 .2.3. Starting the DCS Upgrade Utility 

The DCS upgrade utility can be started from ESD, from the System Maintenance Menu, or 
from the command line. The Upgrade Utility is a stand alone application with the 
following command line syntax: 

10 

upgrade [q or s] 

The qualifier "q" is optional. It is used to pre-test the upgrade to see if it will proceed 
normally. The "s" qualifier is used to indicate that a save and activate will be done if it is 
15 necessary. Either the "q" or "s" is used, not both at the same time. 

1.2.3.1. ESD 

IF ESD is used, ESD will first send a system transaction to the message handler with these 
one of these sets of parameters: 
20 • "d:\upgrade\upgrade /q" - The query of the upgrade started from 

the d: drive. 

• "g:\upgrade\upgrade /q" - The query of the upgrade started from 
the CD-ROM 

25 A query will just run the phase 0 part of the upgrade and place the results in a file 
(upgrade.log). The results include error messages, parameters of the upgrade, the current 
phase of the upgrade, and the size of the disk drive. ESD will check upgrade.log for error 
messages. If error messages are found it will not proceed with the upgrade. If no error 
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messages are found, ESD will send a system transaction to the message handler with these 
parameters: 

o "\f:\upgrade\upgrade" - The upgrade started from the d: drive 

o "g:\upgrade\upgrade - The upgrade started from the CD-ROM 

o '7f:\upgrade\upgrade /s" - The upgrade started from the d: drive 

and a save and activate will be done if necessary. 
o "/g:\upgrade\ upgrade /s" - The upgrade started from the CD-ROM 

and a save and activate will be done if necessary 

1 .2.3.2. System Maintenance Menu 

When the upgrade is started from the system maintenance menu, upgrade.exe is started by 
300UgradeUtil in ngpblist.c. 300UgradeUtil will prompt the user for the source of the 
upgrade file, then call upgrade.exe with these parameters: 

o "d:\upgrade\upgrade /q" - The query of the upgrade started from 
the d: drive. 

o "g:\upgrade\upgrade /q" - The query of the upgrade started from 
the CD-ROM 

When the query is done 300UgradeUtil will parse upgrade.log for error messages. If error 
messages are found, a message will be displayed on a message box on the GUI and the 
upgrade will end. If there was no errors, upgrade.ini will be parsed again for the parameters 
of the upgrade, and prompt for a last chance cancel or start based on the parameters. If start 
is selected, 300UgradeUtil will call upgrade.exe with these parameters: 

o "\f:\upgrade\upgrade" - The upgrade started from the d: drive 

o "g:\upgrade\upgrade - The upgrade started from the CD-ROM 

o "/f:\upgrade\upgrade /s" - The upgrade started from the d: drive 

and a save and activate will be done if necessary, 
o "/g:\upgrade\ upgrade /s" - The upgrade started from the CD-ROM 
and a save and activate will be done if necessary 
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1.2.3.3. Command Line 

When the upgrade is started from the command line, the user will enter send 
"f:\upgrade\upgrade" or "g:\upgrade\upgrade". This should only be used when a 0200 
Controller is upgraded to DCS 300, ver 1.0. No save and activate will be done. 

5 1 .2.4. Upgrade control 

In phase 0 of the upgrade, upgrade.ini will be extracted from each zip file. This file will 
contain the type of the upgrade, the subsections of the type of upgrade, the software 
version of the upgrade, the version level, and a version controller. The parameters will be 

10 used to select the sections of the upgrade that need to be performed. As enhancements are 
made to the DCS 300, and new sections to the upgrade process are identified, additional 
parameters can be added to this file and the upgrade executable. The upgrade.ini file is 
also for security. If the file cannot be extracted from a zip file then the upgrade will not 
proceed. This is what a An upgrade.ini file typically contains the following tags and 

15 parameter definitions will look like : 

[Version_Level] 

Version = 300 x.x 

20 

[Upgrade] 

Type= {SEVERE, MINOR, REBOOT, or SHUTDOWN} 
Version = DCS 300 x.x 

25 

[Changed_Software] 

OS = {YES or NO} 
NEXTGEN = {YES or NO} 
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SWAPPER = {YES or NO} 
BOOT = {YES or NO} 
BOOTMANAGER = {YES or NO} 

[Changed_Partitions] 

OS = {YES or NO} 
NEXTGEN = {YES or NO} 
SWAPPER = {YES or NO} 
BOOT = {YES or NO} 
BOOT MANAGER = {YES or NO} 



START = { BOTTOM or TOP} 
File System = { FAT or HPFS} 
Vtype = { PRIMARY or SECONDARY} 
540 NAME = { currently 0000003f} 
540 SIZE = { the size of the new partition} 
2200_NAME = { e.g. 0000003f} 
2200 SIZE = { the size of the new partition} 
2500_NAME = { currently 0000003f} 
2500_S1ZE = { the size of the new partition} 

[SWAPPER] 

START = { BOTTOM*or TOP} 
File_System = { FAT or HPFS} 
Vtype = { PRIMARY or LOGICAL} 
540_NAME = { e.g. 0000003 f} 
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540 SIZE = { the size of the new partition} 

2200_NAME = { e.g. 0000003f} 

2200 SIZE = { the size of the new partition} 

2500_NAME= {e.g. 0000003f} 

2500 SIZE = { the size of the new partition} 

RestoreSTART = { BOTTOM or TOP} 
Restore_ FileSystem = { FAT or HPFS} 
Restore_ Vtype = { PRIMARY or LOGICAL} 
Restore_540_SIZE = { the size of the new partition} 
Restore_2200_SIZE = { the size of the new partition} 
Restore_2500_SIZE = { the size of the new partition} 

[NEXTGEN] 

START = { BOTTOM or TOP} 

File_System = { FAT or HPFS} 

Vtype = { PRIMARY or SECONDARY} 

540_NAME= {e.g. 0000003f} 

540_SIZE = { the size of the new partition} 

2200_NAME= {e.g. 0000003f} 

2200 SIZE = { the size of the new partition} 

2500_NAME= {e.g. 0000003f} 

2500_SIZE = { the size of the new partition} 

Restore START = { BOTTOM or TOP} 
Restore_ File System = { FAT or HPFS} 
Restore_ Vtype = { PRIMARY or LOGICAL} 
Restore_540_SIZE = { the size of the new partition} 
Restore_2200_SIZE = { the size of the new partition} 
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Restore_2500_SIZE = { the size of the new partition} 

[BOOT] 

START = { BOTTOM or TOP} 

File System = { FAT or HPFS} 

Vtype = { PRIMARY or LOGICAL} 

540_NAME = {e.g. 0000003f} 

540 SIZE = { the size of the new partition} 

2200_NAME = {e.g. 0000003f} 

2200_SIZE = { the size of the new partition} 

2500_NAME= {e.g. 0000003f} 

2500 SIZE = { the size of the new partition} 

[BOOTMANAGER] 

START = { BOTTOM or TOP} 
Vtype = { PRIMARY or LOGICAL} 
540_NAME= {e.g. 0000003f} 
2200_NAME= {e.g. 0000003f} 
2500_NAME= {e.g. 0000003f} 

[Processes] 

NextgenGui = {YES or NO} 
DataCollection = {YES or NO} 
FUU = {YES or NO} 
ViDaemon = {YES or NO} 

[DiskJSize] 

Num_Cylinders_540_D_Drive = { e.g. 97} 
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Num_Cylinders_2200_D_Drive 
Num_Cylinders_2500_D_Drive 



{ e.g. 97} 
{ e.g. 97} 



5 



[VIDEO__FIX] 

FIix_Config = {YES or NO} 
Copy_Files = {YES or NO} 



[Version_Controller] 

Range = {0200 Ver 3.0, DCS 300 Ver x.x - y.y, z.z} 



10 1.2.4.1. Version level 

The version level refers to the parameters that can be stored in upgrade.ini. Upgrade.exe 
(Upgrade.c) contains a version level also. This version level refers to the parameters that 
upgrade.exe can read. The version numbers must match. When upgrade.exe is ran, it will 
compare the two version numbers. If the numbers don't match, the upgrade will end. 

15 1.2.4.2. Upgrade 

The Upgrade header contains the type of upgrade and the version of the upgrade. These are 
the types of the upgrade (upgrade.ini): 



20 



MINOR /* no process need to be stopped, no rebooting */ 
REBOOT /* a major upgrade of the c drive including operating system 
or and upgrade of running d: drive processes on a DCS 



300 with OS/2*/ 



SHUTDOWN /* a major upgrade of the d drive that needs processes 



shut down. This will not be used until the DCS 300 



25 



is migrated to Windows NT. The DCS 300 processes 



should be written with PC hooks to shut down the 



process remotely. */ 
SEVERE /* a severe upgrade of the DCS 300 which includes 
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repartitioning or a new operating system */ 



The SEVERE and SHUTDOWN upgrades will need to specify additional information 
(subsections) in the upgrade.ini. 

5 1.2.4.3. Processes 

The Processes header contains the processes that need to shut down. SHUTDOWN will 
need to specify which processes to stop, such as nextgen.exe or data collection. A NO 
means "don't shutdown processes" and a YES means "shutdown the process". For all 
other types of upgrades this subheading is ignored. 

10 

1 .2.4.4. Changed_Software 

Changed software is only used for SEVERE and REBOOT upgrades. Changed software 
contains a list of the partitions that will have software updates. Changed software is used 
to indicate that the software in a partition has changed. For a SEVERE upgrade, If the 
15 partition size or file system will change, then, the corresponding setting here will also need 
to be set to YES because the software will have to be put back after the partition has been 
reformated. 

1 .2.4.5. Changed_Partitions 

Changed partitions is only used for SEVERE upgrades. All other types will ignore this 
20 information. Changed Partitions contains a list of the partitions that will be changed. If the 
partition is set to NO, it will not be changed. If it is set to YES, it will be changed. Not all 
partitions will change. It is possible that only one will change ( it didn't change size, it 
could change the file system perhaps). If the BOOT partition changed, the SWAPPER 
partition should also be changed. This is so the BOOT partition can change sizes. These 
25 will be set to one if data on the partition changed ( files) or the partition information 
changed ( size, file system, ... ). 
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1 .2.4.6. OS, SWAPPER, NEXTGEN, BOOT, BOOT MANAGER 

These headings are used only if they are set to YES in the Changed_Partitions heading. 
They are only used by SEVERE upgrades. All other upgrades ignore this information. 
The disk drive information is set here. There needs to be partition information for each 
5 partition the was set to YES in Changed Partitions. 

The START parameter indicates if the partition is to be created at the bottom or top of the 
free space on the disk. The current file system is HPFS. This will be changed to FAT for 
Windows NT. The files system type is used by fdisk when the new partition is created and 

10 by format. Vtype indicates if the partition is primary or logical. Usually the operating 
system is on the primary partition and is on the c: drive. The size information is used to 
create the partition. These numbers must be correct for the different drive sizes ( 540M, 
2.5 Gig, and 2.2 Gig) or fdisk will return an error. The name of the drive is important to 
delete the partition using fdisk. The name can be found by doing a fdisk /query. This will 

15 need to be done for all three sizes of drives ( 540M, 2.5 Gig, and 2.2 Gig). If other sizes of 
disk drives are used, the information will have to be added here too. These parameters are 
for fdisk. 

If the name of the partition is not included in the os, swapper, nextgen, or boot sections 
20 (used only if the partition was set to YES in Changed Partitions), then the partition will not 
be deleted. If the size was no included the partition will not be created. And, if the file 
system was not specified, the partition will not be formated. 

For example, for DCS 300 ver 1.0, the swapper partition will need to be deleted, and 
25 recreated at a smaller size because there will be two new partitions. For the swapper 
partition, since it needs to be deleted, the name of the partition will need to be included. 
Since it also needs to be created at a smaller size the, the size should also be included as 
well as the file system. The nextgen and the OS partitions will not be deleted or recreated 
so the size, file system, and name information for the partitions should not be included. 
30 The information on the nextgen and the OS partitions will change, so OS and NEXTGEN 
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should be set to YES under the changed software heading in upgrade.ini. Two new 
partitions will be created - the boot partition and the boot manager. The names for these 
should not be included because they didn't exist before. 

1.2.4.7. Disk_Size 

5 Disk size is the number of cylinders in the d: partition for each of the disk sizes. If a new 
hard drive is added, new entries will need to be added here. Currently in the field there are 
540 Meg hard drives and 2.5 Gig hard drives. Soon there will be 2.2 Gig hard drives. 

1.2.4.8. Video Fix 

There are currently three type of video cards out in the field. For SEVERE upgrades and 
10 reboot upgrades, config.sys will be changed when creat_ng is ran. Also, a new config.ngc 
might be copied over. If the files are changed, they will have to be changed to reference 
the correct video drivers. Fix Config will need to be set to YES if the config.ngc or 
config.sys is changed. If operating system is updated or replaced, then the video driver 
software for the correct card will have to be copied over to the appropriate directories. 
15 Copy_Files will need to be set to YES to cause the files to be copied over. 

1 .2.4.9. VersionController 

The version controller will contain the range of software that can be upgraded. 
For this release it will be 0200 ver 3.0 that can be upgraded. It can be a list or a range such 
20 as 300 ver 3.0 -3.3, 3.5. 

1.2.4.10. Example 

This is the An example upgrade.ini file that will be used for upgrades from 0200 Ver 3.0 to 
DCS 300 Ver 1 .0 is included in the Computer Program Listing Appendix : 

25 

[Version_Level] 
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[Upgrade] 



Type - SEVERE 

Version - DCS 300 Vorl.O 

[ Chang e dS oftware] 

OS - YES 

NEXTGEN- YES 

SWAPPER- YES 

BOOT- YES 

[Chang e d_Partitions] 

SWAPPER- YES 

BOOT- YES 

BOOT MANAGER ~ YES 

[SWAPPER] 

START - BOTTOM 

Filo_Systom - HPFS 

Vtypo- LOGICAL 

510_NAME ~ 

510_SIZE~ 87 

2500_NAME- 0M212ff 

2500_SIZE-317 
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Rootoro_START - BOTTOM 

Re s tore_ Filo System - HPFS 

Rootor o _ Vtypo - LOGICAL 

Rootoro_540_SIZE-95 

5 Ro s tor o _2200_SlZE - 0 

Rc s toro_250Q_SIZE-325 

[BOOT] 

10 START ~ 

Filo_Syotom ~ HPFS 

Vtypo - LOGICAL 

510_SIZE-6 

2200_SIZE ~ 0 

15 2500 S1ZE ~ 6 

[DOOT_MAMAGER] 

START - TOP 

20 Vtypo ~ PRIMARY 

[DiokSizo] 

Num_Cylindoro_510_D_Drivo - 97 

Num_Cylindoro_2500_D_Drivo - 710 

25 

[VlDEO_FIX] 

FIix_Config ~ YES 

[Voroion_Control1 e r] 

30 — ■ Rango- 0200 Vor 3.0 
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The type of this-upgrade shown in the example upgrade.ini file is SEVERE because the 
upgrade needs to delete and create partitions. The only partition that will be deleted is the 
swapper partition. It is being deleted to make room for two more partitions. The two new 
5 partitions are the alternate boot partition (BOOT) and boot manager. The swapper partition 
will be recreated at a smaller size. The OS and nextgen partitions will not be deleted or 
recreated, but new files will be copied over. 

Since the swapper, the boot, and the boot manager partitions will change size, the 
10 SWAPPER, BOOT, and BOOTMANAGER settings under changed_partitions are set to 
YES. 

Data for all the partitions will change, so all the values in the Changed_Software are set to 
YES. 

15 

For the SWAPPER section, all the information for the partition is added except the name 
and size of the partition for the 2.2 Gig drive because none exist out in the field. 

For the BOOT section, the boot partition name is not included because no boot partition 
20 was there before so no deletion of the partition will be attempted. The delete sections of 
the upgrade looks for the name of the partition to delete. If the name is NULL the section 
will be skipped. The new partition will be created at the top ( START = TOP) of the free 
space on the hard drive. 

25 For the BOOT MANAGER section, the new partition will be created at the top ( START = 
TOP) of the free space on the hard drive. The name is not included because boot manager 
was not installed before. 

Creat_ng will be ran, so FixConfig under Video_Fix will be set to YES. 

30 
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For the Version Controller section, controller with 0200 Ver 3.0 software can be upgraded 
to DCS 300 Ver 1.0. 

1 .2.5. Upgrade.log file 

Upgrade messages will be sent to the controller screen as well as to a file, upgrade.log. At 
the beginning of the upgrade, a default upgrade.log will be copied over to d:\upgrade. 
Phase 0 messages are used by ESD and 300UgradeUtil to determine if the DCS upgrade 
utility will proceed without errors. This is what the default message file looks like: 

[PHASE] 

phase = 
[DISKSIZE] 

disksize = 
[VIDEO_CARD] 

VIDEO_CARD - 
[ERROR_MESSAGES] 
[SUCCESS_MESSAGES] 

If the upgrade is SEVERE and the d: partition is to be deleted and recreated, the 
upgrade.log will be copied over to the f: drive befor the d: drive is deleted. 
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1.2.5.1. Phase heading 

At the completion of each phase, the next phase to be ran is set here. There are currently 
six phases (0, 1, 2, 3 ,4, and 5). None of the upgrades use all six phases. The MINOR 
upgrade only uses phase 0 and phase 5. A REBOOT upgrade uses phase 0, phase 4, and 
5 phase 5. A SEVERE upgrade uses phase 0, phase 1, phase 2, phase 3, and phase 5. A 
SHUTDOWN upgrade only uses phase 0 and phase 5. 

1.2.5.2. Disk Size heading 

The disk size is written to upgrade.log if the upgrade is SEVERE. An IOCTL command is 
10 ran that queries the number of cylinders in drive. 

1.2.5.3. Video Card heading 

This is used for SEVERE and REBOOT upgrades. 

1 .2.5.4. Error Messages 

15 

These are the error messages that can be put in upgrade.log in phase 0: 

• Invalid disk size 

• Invalid zip files(s) 

• The upgrade files are not compatible with the DCS upgrade utility 
20 • The path for the upgrade files is incorrect. 

• The upgrade.ini is incorrect. 

• Incorrect number of parameters 

• DCS 300 ver x.x can not be upgraded to DCS 300 ver y.y. You 
must first upgrade to DCS 300 ver z.z the use this upgrade. 

25 

These are the error messages that can be put in upgrade.log in all other phases: 
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Creat_ng failed. The error messages can be found in TBD. 

The upgrade completed with errors 

The upgrade could not complete 

Error Copying files to C: Drive 

Error Copying files to D: Drive 

Error Copying files to F: Drive 

Backup failure: 

Restore failure: 

"Could not open master system file list. 
Restore is in progress... 
Backup is in progress... 
Target directory creation error. 
ERROR - Access to drive denied 
Could not open the migration list file. 



15 1.2.5.5. Success Messages 

These are the success messages that can be put in upgrade.log in phase 0: 

• DCS 300 ver x.x will be upgraded to DCS 300 version y.y. 

• 0200 Controller ver 3.0 will be upgraded to DCS 300 version 1 .0. 



20 These are the success messages that can be put in upgrade.log in all other phases: 

• Successful upgrade 

1 .2.6. Save and Activate 

If the /s parameter was passed in, a SEVERE and REBOOT upgrade will test to see if a 
save and activate is necessary. If the save and activate is necessary, the new default files 
25 will be copied over. Then data collection will be stopped, CM/2 will be ran, and then 
LAPs will be initiated. Timers will be used to wait to wait for data collection to stop, and 
for CM/2 setup and LAPs to finish. 
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1 .2.7. Assumptions 

1 .2.7.1 . Processes that need to be in place for the upgrade utility 

It is assumed that there will be a config file that contains information on the software 
5 version. This will help control upgrades because the DCS 300's software version can be 
compared to the version controller in the upgrade files. 

For ESD to start the DCS Upgrade Utility, a new functionality needs to be added that can 
spawn a command line utility based on a transaction. 

10 

The GUI needs to be changed to add the DCS 300 Upgrade Utility to the menu options. If 
the Upgrade Utility was selected, a new procedure in ngpblist.c will start the upgrade with 
the query option and examine the results in upgrade.log when the query is done. If there 
were no error in upgrade.log, the GUI will show a last chance box based on the type of 
15 upgrade (the type of upgrade is also in upgrade.log). If START was selected, the upgrade 
utility will be started without the query option. 

The GUI needs to be changed to continuously check to see if there is an IPC call for a quiet 
save and activate. The upgrade utility will need to be able to do a quiet save and avtivate 
20 without rebooting or user input. Existing procedures like ActivateCfgOK, DcStopTimer, 
ActivateAfterStop, CheckCmsetup, ActivateAfterCM2, CheckLapsDone, and 
ActivateAfterLaps and the procedures they call will need to able to accept two more input 
parmater ( quiet, or not quiet, and no reboot, or reboot possible). 

1.2.7.2. Limitations 

25 When an upgrade to DCS 300 ver 1 from 0200 ver 3.0 is done, no save and activate will 
occur because the changes to the DCS software are not in place. Also, the upgrade will 
need to be started from the command line for the same reasons. 
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The SHUTDOWN type of upgrade will not be used until the DCS 300 is migrated to 
Windows NT. The new DCS 300 processes should be written with IPC hooks to stop them 
remotely. 

5 Much of the previous upgrade kit (upgrade to V3.0 on CD-ROM) can be used. 

Changes will need to be made to the sections, though. Phases of the upgrade will be 
used again with the addition of the upgrade parameter list in upgrade.ini. 

1 .2.8. Software Structure 



10 1.2.8.1. ngpblist.c 

For upgrades started from the GUI, code will need to be added to ngpblist.c to add the DCS 
300 Upgrade Utility. A new dialog will be created when this option is selected. Under the 
create event of this dialog a new function (300UgradeUtil) will be added that will prompt 
the user for which directory the upgrade files are in. Based upon the choice, 300UgradeUtil 

15 will call upgrade.exe with these parameters: "upgrade /d:\upgrade /q", if "D: Drive" was 
selected or "upgrade /g:\upgrade /q" if the "CD-ROM" option was selected. Upgrade.exe 
will perform phase 0 of the upgrade and quit. Phase 0 determines if the upgrade files are 
valid, extracts upgrade.ini from the upgrade files, determines if the upgrade.exe is 
compatible with the upgrade.ini, and determines the type of upgrade. The results of phase 

20 0 is output to upgrade.log. Then upgrade.exe ends. The CreateUpgradeUtil function 
spawns the upgrade.exe. It then starts a xvt timer and for each timer event generated, calls 
CkUpgradeLogFile. This function looks for the update.log file and when successfully 
opened verifies that no errors were generated by the upgrade.exe application. If errors are 
present, they are presented to the user in a XVT message dialog otherwise the success 

25 message that was written to the log file is displayed. If there were no errors, and based on 
the type of upgrade, a last resort box will show asking if the user wants to start or cancel 
the upgrade. 
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1.2.8.1.1. Pseudo-code for ngpblist.c 



This is th e procedure Pseudo-code for example procedures that SideButtonsMenuListOk 
calls for the upgrade utility are included in the Computer Program Listing Appendix in file 
5 "ngpblist.c." These procedures include : 

© SideButtonsMenuListOK 

© Creat eUgradeU t i 1 

1 .2.8.1. LPseudo cod e for ngpblist.c 



|0 /***************************^ 

* NAME: SideButtonsMenuListOK 

15 * DESCRIPTION: Handle s dialog OK processing for the 

* Menu List dialog. The dialog is called for the 

* item selected in the list. 

it 

* REVISION: 

20 * 09/22/95 BK Added (LONG) pltom to xvt dlg_cr o ate_res call 

* 09/29/95 SL Added NgStatusMonitor call 

* 10/16/95 SL Remove NgStatusMonitor call 

* 10/25/95 SL Added NgStatusMonitor call 

* 11/09/95 SL Added DisplayErrorlog call 
25 * 11/12/95 SL CroatoAppListDlg call 

* 11/12/95 SL Croat o S o ndTranDlg call 

* 11/15/95 SL CreateTraceDlg call 

* 12/19/96 BK Destroy menu list dig before calling selected function. 
* Can't creat e a modeless dig from a modal dig. 



* 11/6/97 — DH Added DCS upgrade utility ontry 
******************************************************* 

VOID SBMonuListOK (WINDOW xdWindow) 
5 /* dialog window handl e — */ 

PSBMENULIST psbMenuList; /* menu list structur e pass e d in */ 

PSBMENUITEM plt e m; /* m e nu it e m from list */ 

— INT ilndex; /* index in listbox of item selected */ 

10 

pobMonuList - (PSBMENULIST)xvt_vobj_ j get_dato (xdWindow); 

ilnd o x ~ xvtjiotgctoelindex (CTL_WIN(LB_AVAILABLE)); 
pltem ~ psbMenuList >p s bMenuItems + ilnd e x; 

15 

if (pltem >iRid — DBSTATUSMONITOR) 

NgStatusMonitor (); 

else if (pltem >iRid — DB ERRORLOG) 

20 DisplayErrorlog (); 

el s e if (pltom >iRid — DBAPPLICATION) 

CrcatoAppListDlg (); 

ols o if (pltem >iRid — DB_TRACE) 

Cr e at e TraceDlg (); 

25 olso if (pltom >iRid — DB UPGRADEUT1LITY) 

UpgradoUtility (FUU_START_GUI); 

o ls o if (pltem >iRid — DBSENDTRAN) 

Creat e S e ndTranDlg (); 

el s e if (pltem >iRid — DB_300_UPC_UTIfc ) 
30 — /* the DCS upgrade utility was selected */ 
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CrcotcUgrndeUtil Q; 



e lse if (pltem >eh !~ 0) 
-f 

5 if (!xvt_dlg_croato_ros (WD MODAL, pltom >iRid, EM_ALL, 

pltem >eh, (LONG) pltem)) 

xvt_dm_post_error ("Can't open dialog"); 

-f 
els e 

10 -f 

xvt_dm_posterror ("Not implemented at this time."); 

return; 

15 | 

it 

20 * NAME: CroatcUpgradeUtil 

* DESCRIPTION: Ask user whore the upgrade files are located. 
* Determin e s the type of upgrade: sever, minor, 

■* r e boot, or shutdown. Based on th e typ e of upgrade, 

25 ifc pr e sent a last chance to quit box 

•t 

* ASSUMPTIONS: Non e . 
it 

it 

30 * 
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* REVISION HISTORY: 

* — Date Author Description 



5 * 11 6 97 — Doug Hughes Original code. 

± 

******************************* 
****/ 

10 VOID CreateUpgradeUtil (WINDOW xdWindow) 

/* Dialog box window handle. */ 

i 

Show a dialog box that asks where the upgrade files are located. Show 2 
choices, CD ROM and "D: Drive". Make the D drive the d e fault. 
15 If the choice made was Cancel, quit the upgrade. 

Check to see if save and activate was unselected. 
If th e choice made was Start, continue 

call ugprade.exe with "upgrade /g:\upgrade /s" or "upgrade /gAupgrade /s" if 
save and activate was selected. 
20 call ugprade.ex e with "upgrade /gAupgrade" or "upgrade /gAupgrade" if save 

and activate was unselected. 



1 .2.8.2. UpgradeUtilOk (WINDOW xdWindow) 
25 This function is called when the user clicks the OK button in the DCS 

Upgrade Utility dialog. 
If CD-ROM was selected as the source then verify a CD is in the drive. 
If not display an error. 

Spawn the upgrade.exe application using the /q (query) option for a parameter. 
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Start the xvt timer 

1 .2.8.3. CkUpgradeLogFile(VOID) 

This function is called when a EJTIMER event is received in the DCS Upgrade Utility 
dialog. 

Loop until a successful open is performed on the upgrade.log file or until 
nn timer events have be generated. If we time out, then inform the user 
and quit the process. 

After a successful open is performed, parse the upgrade.log file using the 
function: 

LONG FindValue ( PSZ pszFilePath, 

PSZ pszSection, /* "[ERRORMESSAGES] */ 
PCHAR szFindString) 

• If no errors are found then parse the file again and display the messages 
written under the "[SUCCESSMESSAGES]" section in a xvt_note 
dialog. 

• When we return from the note dialog, parse the upgrade.log file and find 
the type, (section = "[UPGRADE_TYPE]"). 

• Based on the type, display the appropriate dialog (see functional spec, for 
the different levels of upgrades. 

If the type is MINOR or SHUTDOWN, show the user a Start or Cancel 
type dialog allowing the user to proceed or abort the process. 
Upgrade.exe is again called with no paramters. 

IF the type is REBOOT or SEVERE, show the user a Star or Canel type 
dialog along with a check box to Save and Activate their current 
configuration. 

Upgrade.exe is again called and if the Save and Activate check box is 
checked, then /s is passed in as a parameter to the call. 
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1.2.8.4. Upgrade.exe 



There are six phases to the upgrade. Phase 0 tests to see if the upgrade files are valid and 
examines the parameters of the upgrade. Phases 1, 2, and 3 are for SEVERE upgrades 
only. Phases 1 , 2, and 3 delete, create, and format partitions. Phase 4 reboots the DCS 
300 to the f: drive if the type of upgrade is REBOOT. MINOR and SHUTDOWN upgrades 
will jump from phase 0 to phase 5. Phase 5 extracts the zip files. 

1.2.8.4.1. Phase 0 

Phase 0 does these tests for each possible zip file: 

• A check is done to see if the zip file exists ( it is not an error if 
it does not exist) 

• If it exists the upgrade.ini is extracted from it 

• If there wasn't an upgrade.ini and error is logged to 
upgrade.log and the upgrade ends. 

• If there was an upgrade.inii, its version is compared to the 
version of upgrade.exe. 

• If the versions don't match, an error message is logged in 
upgrade.log and the upgrade ends. 

At this point, if there is no upgrade.ini, an error message is logged to upgrade.log and the 
upgrade ends. If there is an upgrade.ini the version of the DCS 300 is compared to the 
version controller in upgrade.ini. If the DCS version doesn't fall in the range in the version 
controller, an error message is logged to upgrade.log and the upgrade ends. Next the type 
of upgrade is retrieved and logged to upgrade.log. If it is a SEVERE upgrade, the disk size 
is also logged to upgrade.log. If no errors have occurred, the success messages is logged to 
upgrade.log. The message tells the current version of the DCS 300 and the version it is 
being upgraded to. If the "q" parameter was used to call upgrade.exe, the upgrade will end. 
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If the 'q" parameter was not used the phase is set to the proper value and the upgrade 
continues. The new phase is logged in upgrade.log. 

1 .2.8.4.2. Phase 1 (used by SEVERE only) 

The DCS 300 will do a save and activate if the Is parameter was passed in. 

5 

Phase 1 will extract upgdbkup.lst from one of the zip files and back up the users system 
files to the d:\upgrade directory. In phase 2 these files will be copied to the boot partition 
(f: drive). 

10 If BOOT = YES was set in upgrade.ini, phase 1 will delete the swapper partition if the 
name was set in upgrade.ini. This is so the boot partition can change sizes. Next, the boot 
partition will be deleted if the the name was set in upgrade.ini. If the delete of the boot 
partition failed an error message recorded to upgrade.log. The old partition settings will be 
in the upgrade.ini. If the partitions were deleted successfully, the new boot partition will 

15 be created if the size is not equal to zero. 

Phase 2 will be entered in the upgrade.log so that when the DCS reboots, phase two will be 
started. 

20 A new config.sys and startup.cmd will be copied over the old so that when the DCS 300 
reboots to the c: drive, the upgrade program will run. 

Now the DCS 300 will reboot if it hasn't already. 

1.2.8.4.3. Phase 2 (used by SEVERE only) 

25 Phase two will format the swapper partition in the specified file system if the file system 
was set in upgrade.ini. If it fails, an error message will be recorded to upgrade.log and a 
error message will print to the screen and the upgrade will end. The DCS 300 is not 
functional but it is bootable to the C: drive. 
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If no error occur, the boot partition will be formatted in the specified file system if the file 
system was set in upgrade.ini. If an error occurs, an error message will be written to 
upgrade.log and the DCS 300 will be set up to boot up normally and the DCS will reboot to 
5 the C: drive. The DCS 300 is fully functional, but the upgrade failed. If no errors occur, 
boot_drive.zip will be exploded into the new drive and the backed up system files will be 
copied over as well as the upgrade.ini and upgrade.log files. 

If errors occur during the copying, an error message will be written to upgrade.log and the 
10 DCS 300 will be set up to boot up normally and the DCS will reboot. The DCS 300 is fully 
functional, but the upgrade failed. If the e: drive was not deleted before, it can be now if 
SWAPPER = YES under the changed partitions heading in upgrade.ini. If it fails, an error 
message will be recorded to upgrade.log and a error message will print to the screen and the 
upgrade will end. The DCS 300 is fully functional. 

15 

If there was no errors and If NEXTGEN = YES under the changed partitions heading in 
upgrade.ini, the d: drive will now be deleted if the name was set in upgrade.ini. If it fails, 
an error message will be recorded to upgrade.log, the swapper partition will be recreated, 
an error message will print to the screen, and the upgrade will end. The DCS 300 is not 
20 functional but it is bootable to the C: drive. 

If there was no errors and If OS = YES under the changed partitions heading in upgrade.ini, 
the c: drive will now be deleted if the was set in upgrade.ini. If it fails, an error message 
will be recorded to upgrade.log, an error message will print to the screen, and the upgrade 
25 will end. The DCS 300 is not functional but it is bootable to the c: drive. 

If there were no errors, the deleted partitions will now be recreated through fdisk if the 
sizes were set in upgrade.ini. If a partition creation fails, an error message will be recorded 
to upgrade.log, an error message will print to the screen, and the upgrade will end. The 
30 DCS 300 is not functional and it is not bootable to the c: drive. 
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If no errors occur creating the partitions, the DCS will reboot to the f: drive if OS, 
NEXTGEN, or SWAPPER is set to YES under the changed partitions heading in 
upgrade.ini. 

5 1 .2.8.4.4. Phase 3 (used by SEVERE only) 

Phase three will first format the os partition in the specified file system if the file system 
was set in upgrade.ini. If the format fails, an error message will be recorded to upgrade.log, 
an error message will print to the screen, and the upgrade will end. The DCS 300 is not 
functional and it is not bootable to the c: drive because there is no operating system on the 
10 c: drive. The DCS 300 was booted from the f: drive and is at a command prompt. 

If there are no errors, the nextgen partition will be formatted in the specified file system if 
the file system was set in upgrade.ini. If the format fails, an error message will be recorded 
to upgrade.log, an error message will print to the screen, and the upgrade will end. The 
15 DCS 300 is not functional and it is not bootable to the c: drive because there is no operating 
system on the c: drive. The DCS 300 was booted from the f: drive and is at a command 
prompt. 

If there are no errors, the swapper partition will be formatted in the specified file system if 
20 the file system was set in upgrade.ini. If the format fails, an error message will be recorded 
to upgrade.log, an error message will print to the screen, and the upgrade will end. The 
DCS 300 is not functional and it is not bootable to the c: drive because there is no operating 
system on the c: drive. The DCS 300 was booted from the f: drive and is at a command 
prompt. If there are no errors, the upgrade zip files are now ready to be exploded - 
25 increment the phase to 5 . 

1 .2.8.4.5. Phase 4 (used by REBOOT only) 
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The phase is set to 5 in the log file. The DCS 300 will do a save and activate if the /s 
parameter was passed in and if a save and activate is necessary. Now the DCS 300 will 
reboot. 



1.2.8A6. Phase5 

5 

If REBOOT was set in upgrade.ini, upgdbkup.lst will be extracted from one of the zip 
files. This is the list of files to be backed up and restored. The system files will be copied 
to the d:\upgrade\backup directory. If the backup fails, an error message will be recorded to 
upgrade.log, an error message will print to the screen, and the upgrade: will reboot the DCS 
10 300 to the c: drive. The DCS 300 is fully functional and operation will resume as normal 
except the upgrade did not complete successfully. 

If the REBOOT parameter is set under the changed partitions heading in upgrade.ini, 
upgrade.exe will run CreatUpgradeTmpFile. This procedure will read the last successful 
15 section from ng_confg.log and copy it to a temp file to be used when creating is ran. If the 
CreatUpgradeTmpFile fails, an error message will be recorded to upgrade.log, an error 
message will print to the screen, and the upgrade will reboot the DCS 300 to the c: drive. 
The DCS 300 is fully functional and operation will resume as normal except the upgrade 
did not complete successfully. 

20 

If the SHUTDOWN parameter is set under the changed partitions heading in upgrade.ini, 
the nextgen processes will now be stopped. 

For all upgrades, the zip files will now be extracted to the appropriate drive and directories. 
25 If OS=YES under the changed_software heading in upgrade.ini, os_drive.zip will be 
exploded in the c: drive. If the unzip fails, an error message will be recorded to 
upgrade.log, an error message will print to the screen, and the upgrade will end. The DCS 
300 is might or might not be functional and it might or might not be bootable. The status is 
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unknown because the c: drive is corrupted. The DCS 300 was booted from the f: drive and 
is at a command prompt. 

If there is no errors and NEXTGEN=YES under the changed_software heading in 
5 upgrade.ini, nextgen_drive.zip will be exploded in the d: drive. If the unzip fails, an error 
message will be recorded to upgrade.log, an error message will print to the screen, and the 
upgrade will end. The DCS 300 is might or might not be functional but it is bootable to the 
c: drive. The DCS 300 was booted from the f: drive and is at a command prompt. 

10 If there is no errors and the REBOOT or SEVERE parameter is set, creat ng will be ran to 
restore the user configuration. If the creating fails, an error message will be recorded to 
upgrade.log, an error message will print to the screen, and the upgrade will reboot to the c: 
drive and end. The DCS 300 is functional but not configured. 

15 If there is no errors and the REBOOT or SEVERE parameter is set, the procedure 
systemRestore will be ran to restore the backed up system files. If the systemRestore fails, 
an error message will be recorded to upgrade.log, an error message will print to the screen, 
and the upgrade will reboot to the c: drive and end. The DCS 300 is functional but not 
configured fully. 

20 

If there is no errors and the REBOOT or SEVERE parameter is set, the procedure 
EnableTcpipInConfigSys will be ran to start TCP/IP in the config.sys if it was set before. If 
TcpipInConfigSys fails, an error message will be recorded to upgrade.log, an error 
message will print to the screen, and the upgrade will reboot to the c: drive and end. The 
25 DCS 300 is functional but not configured fully. 

If there is no errors and the REBOOT or SEVERE parameter is set, the procedure 
HostNAMeRestore will be ran to restore the host name in config.sys. If HostNAMeRestore 
fails, an error message will be recorded to upgrade.log, an error message will print to the, 
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screen, and the upgrade will reboot to the c: drive and end. The DCS 300 is functional but 
not configured fully. 

If the REBOOT or SEVERE parameter is set, the DCS 300 will now reboot to the c: drive 
5 and be ready for normal operation. 

If the SHUTDOWN parameter is set, the stopped processes will now be restarted. 

If there was any errors configuring the controller fully, the user will have to reconfigure the 
10 DCS 300. 

1 .2.8.4.7. Pseudo-code for upgrade. c 

The main body of upgrade.c calls these functions: 
15 • main 

• SearchAndAddStringtoFile 

• FormatPartition 

• DiskSize 

• CreatePartitions 
20 • IncrementPhase 

• HostNameRestore 

• FindValue 

• UpdtConfigLog 

• SystemBackup 
25 • SystemRestore 

• CreateUpgradeTmpFile 

• DosExecPgm Wrapper 

• EnableTcpipInConfigSys 

• SaveAndActivate 
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• RestoreVideoType() 

• SaveVideoType() 

A copy of pseudo-code for an example "upgrade.c" file is included in the 
Computer Program Listing Appendix. 

5 1 .2.8.4.8, Pseudo-code for Upgrade.h 

A copy of pseudo-code for an example header definition is included as file 

"upgrade.h" in the Computer Program Listing Appendix. 
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1.2. 8. 1.7. cod e for upgrad e .c 
1.2.8.1.7.1. Main body 



5 ********* 

* FILE NAME; upgrade.c 



PURPOSE: — Main module for upgrade.c, used to do field 



10 4 upgrades. * 

* AUTHOR: D. Hughes, D Kaatz 



* DATE: 11/2/97 



* REVISION HISTORY: 



15 4 — Date Author Description 



4 — 1 1/2/97 — Doug Hughes — Original code 



Dave Kaatz 



* COPYRIGHT (o)1997 INTERMEC CORPORATION, ALL RIGHTS 
20 * RESERVED * 

*********y 



#d o fino INCL DOSSESMGR 
25 //define INCL DOSFILEMGR 
//define INCL_DOSPROCESS 

//dofino INCL_DOSDEVICES 
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//dofino INCL DOSDEVIOCTL 
//define INCL DOSFILEMGR 
tfdofine INCL DOSERRORS 
ffdofino INCL_DOSPROCESS 
5 //define INCL DOS 

//include <stdlib.h> 
//include <string.h> 
//include <conio.h> 

10 

//include <ctype.h> 
//include <locale.h> 
//include <fcntl.h> 
//include <errno.h> 
15 //include <io.h> 

//include "dcsys.h" 

//include "dcmuser.h" 

//include "lnkl s tgp.h" 
20 //include "fil o s_gp.h" 

#include "libutlgp.h" 

//include "autcongp.h" 

//include "mem.h" 

//include "creatng.h" 
25 //includ e "fiold_ng.h" 

//include "upgrade.h" 

/****** 

****** //DEFINES 
30 ******/ 
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//d e fine STR_WARN_TWO "Mak e a n e w syst e m backup disk e tte wh e n th e upgrad e has 
compl e t e d.\n" 

tf define P ROTO T A RG ET FI LE "protocol.tmp" 

5 #define BACK PROTO FILE "protocol.bac" 

tfdofino OLDPROTOTOKENRSECTION — "[IBMTOKjiif]" 
tfdofino NEW_PROTO_TOKENR_SECTION — "[NGTRING nif]" 

10 ** Global variables 
H 

CHAR pszSystomFilos[MAXPATH]; 

static CHAR szWhites[] - (SP,'\t',NUL) ; /* select ignored white chars — H 
static CHAR szSkips[] - (SP,'-','\t',NUL] ; 
15 BOOL bDcbug - FALSE; 

l± 

** Prototypes 

20 

LONG DeletePartition s ( PCHAR pszDiskName); 

LONG SearchAndAddStringtoFile(PSZ pszFileNamcPath, PSZ pszSection, 

PSZ pszSetting, PSZ pszlns e rtString) 

LONG FormatPartition (PCHAR pszDrive, PCHAR pszFil e Syot e m); 
25 LONG CroatoPartitions( LONG IDislcSizo, LONG lTyp e , INT iStartabl o , 
PSZCHAR pszFileSystom, CHAR cStart); 

LONG lncromontPhaso( VOID ); 
LONG HostNam e R e store( void ); 
30 LONG DiskSize(VOID); 
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SZ FindValue (PSZ pszFil e Path, PSZ pszSection, PSZ szSetting); 

LONG UpdtConfigLog( void ); 

LONG SystomBackup(PSZ pszPath ); 

LONG Sy s t e mR e store( PSZ pszPath ); 
5 LONG CreateUpgradeTmpFilo(PSZ pszPath ); 

LONG DosExocPgmWrapp o r(PCHAR szPgm, PCHAR szArgs); 

LONG EnableTcpipInConfigSys(VOID); 

VOID Phaso_Z o ro(); 

VOID Phasc_One(); 
10 VOID Phas e _Two(); 

VOID PhaGO_Throo(); 

VOID Phaoo_Four(); 

VOID Phaoe_Fiv e (); 

CopyVid e oDriv e r s () 
15 Fix Video lnConfigSys() 

main program function 

20 DESCRIPTION: — Th e upgrad e works in stat e s, call e d phases h e r e . 

Th e number of phas e s is fiv e . Th e first phas e ( phas e 0) ch e cks 

to s ee if th e zip files exist and ar e valid and ch e ck s v e r s ion 

numbers for an appropriat e upgrade. Phases 1 thru 3 are for 

SEVERE upgrad e s. In phases 1 thru 3, th e boot partition can 

25 b e deleted, a n e w creat e d in a specified file syst e m and siz e . 

Th e n, th e other partitions can b e d e l e t e d and re creat e d in the 

specified file system and size. Th e sixth phas e (phas e 5) 

p e rforms th e upgrad e . 

30 Curr e nt phas e is writt e n to upgrad e .log on th e d:\upgrade 
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directory. 

The phase is updated at the completion of e ach phas e . 

If th e upgrad e is SEVERE, upgrade.log is copied to th e f: driv e 

5 if/after f: has been format e d. 

AUTHOR: Doug Hughes (major) and David Kaatz (assistance) 

DATE: 11/2/97 

|Q *********************** 

int main(argc argv) 

CHAR azFi1oNamoPoth[MAXPATH]; 
15 CHAR szS o archString[MAXPATH]; 

CHAR ozInsortString[MAXPATH]; 

INT — ilnstance ~ 0; 

LONG IDiokSizo - 0; 

LONG lPhaso-0; 
20 LONG lRo-RC_OK; 

INT i; 

ULONG ulRooorvod; 

CHAR ozPhas e Numbor[35]; 

CHAR — *pszPhas e N umb e r; 
25 UCHAR LoadError[CCHMAXPATH]; 

PSZ Enva - NULL; 

PSZ Argo - NULL; 

RESULTCODES ChildRC; 

APIRET re - NO ERROR; 
30 LONG IRC -NO ERROR; 
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BOOL fFiloExiots; 
BOOL fQuory - FALSE; 
BOOL fSaveActivate - FALSE; 
PSZ pozTomp[NG_BUF_IN_LEN]; 
5 PSZ pszPath[PATH]; 

PSZpszFullPath[PATH]; 

BOOL fHiddonFile; 
PSZ p s zUpgradeSource[l 5) ; 
10 CHAR chParamcter-NULL; 
INT iNumParams ~ 0; 
INT iUpgrad e Typ e ; 
PSZ pszUpgrad e Type; 

15 BOOL fBootPartitionChangcd - 0; 
PSZ pszBootPartitionNam e ; 
LONG lBootPartitionSize; 
PSZ pozBootPartitionFS; 
CHAR cBootPartitionStart; 
20 — INT iBootPartitionT>po; 

— BOOL fDel e teAdjancentPartition - 0; 
— LONG lAdjac e ntPartitionNam e ; 
INT iBootPartitionStartable - 0; 

25 BOOL fOSPartitionChanged - 0; 

PSZ pozOSPartitionName; 

LONG lOSPartitionSize; 

PSZ pozOStPartitionFS; 

CHAR cOSPartitionStort; 
30 — INT iOSPartitionTypo; 
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INT iOSPartitionStartabl o - 0; 



BOOL fN c xtG o nPartitionChanged ~ 0; 
PSZ pszN e xtGenPartitionNam e ; 
5 LONG INextGenPartitionSize; 
PSZ pszNextGentPartitionFS; 
CHAR cNextGcnPartitionStart; 
— INT iNextG e nPartionTyp e ; 
INT iNextGenPartitionStartable - 0; 

10 

BOOL fSwapperPartitionChanged ~ 0; 
PSZ pszSwapperPartitionNam e ; 
LONG ISwapperPartitionSize; 
PSZ pszSvvappertPartitionFS; 
15 CHAR cSwapperPartitionStart; 
— INT iSwapperPartitionType; 
INT iSwapperPartitionStartable - 0; 

20 CHAR szSysCmdStr[NG_BUF_IN_LEN + NG_BUF_IN M LEN+2]; /* for 
syst e m copy command — H 

CHAR szErrorOut[MAX_ERROR_OUT_LEN + 1]; /» for e rror output 
strings — */ 

INT iSysR e turn - 0; /* for r e turn from syst e m call */ 

25 

INT ilniLev e l ~ 0; /♦ — the lev e l that upgrade.ini is at. If new 

parameters ar e added to upgrad e .ini 

its level would change to 1.1. — This 

l e v e l needs to match iExeLev e l. 

30 n 
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INT iExeiL e vel ~ 1 .0; /* th e lev e l that upgradeex e is at. If new 

parameters are added to upgrade. e x e 

its l e vel would change to 1.1. This 

lev e l n e eds to match th e lev e l in upgrad e .ini 

5 n 

— check for upgrad e .ini 

— if upgrade.ini exists d e let e it 

10 — Copy generic upgrade.log over to d:\upgrade 

moms o t(pszPath ? NUL,P ATH+ 1 ); 
memset(pszFullPath ; NUL,PATH+l); 

15 — iNumParams ~~ argc; 
— if(iNumParams !> 2) 



/* Source of upgrade files not specified */ 

print error message to screen and to upgrade log fil e 

20 quit upgrade; 

-i 

— else 

— { 

for(i~0; i < iNumParams; i++) 

25 { 

- if(otmcmp(StrToUupr(argv(i))//Q', 2)); 

{ 

fQuory-TRUE; 

} 

30 e ls e if(otmcmp(StrToUupr(argv(i)) > 7S^ 2)); 
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4 

fSavoActivate - TRUE; 

4 



els e if (strstr(argv(i), ; :V ? )) 



4 

— strcpy(pszPath,argv(i)); 

4 



— ) /* end of for */ 
-] — /* end of else */ 



10 I 



sprintf(pszFullPath/'%s%s ;, ,pszPath, LOGFILE); 

lPhase ~ FindVaruo(pszFullPath, PHASE, PHASE); /* determine the 

phase number */ 

15 memset(pszFullPath,NUL,PATH+l); 

/* Phase zero is used by all pha se s. 

— Phase zero checks to see if the zip files ar e 

— valid 

20 

ifilPhas e — 0) 

4 

— Phase_Zero(); 



4 

25 /* Phase on e is used by SEVERE upgrades only. 
Phase one can delet e /create the boot partition, 
it can delete/create the boot manager too. 
-*/ 

if(l Pha s e — 1) 
30 /* sever e upgrad e */ 
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-4 

— Phase_On e (); 

-4 

5 /* Phase two is for SEVERE upgrades only. 

Phase 2 does the following: 

Formats the new boot partition, 

Copies th e n e w op e rating system to th e boot partition 

Delete and create any other partitions 

10 — */ 

if(lPhas c — 2) 

Phase_Two(); 

} /* end of phase 2 */ 

15 

/* Phase three is for SEVERE upgrades only. 
— Phase three reformats the recreated partitions 
-*/ 

if(phase — 3) 
20 H 1 

Phase_Three(); 

-4 

/* Phas e four is for REBOOT upgrad e s only 

25 Phas e four do e s a sav e and activat e and 

r e boots to th e alt e rnat e operating system 

— */ 
If(lPhaso " 4) 
/* REBOOT */ 
30 — { 



[1 1 0-11 8 265/ . 16 8 959_l.DOC] 



67 



Phas e FourQ; 



— ) ; /* end of phase 1 */ 

/* Pha s e 5 does the following: 

system backup REBOOT 

CroatoUpgradeTmpFile REBOOT 

Stop nextgen processes SHUTDOWN 

e xplodes *.zip ALL TYPES 

system restore REBOOT 

hostname restore REBOOT 

proto ini merge REBOOT 

Restart shutdown processes SHUTDOWN 

If(lPhase — 5) 

/* Now booted from operating sy s tem on f: if REBOOT or SEVERE */ 
Phase_Five(); 

-4 

} // end of main function 

1 .2.8 A .7.1 . 1 .SavoAndActivate 

FUNCTION: SavoAndActivat e 

AUTHOR: D. Hughes 

DESCRIPTION: — Sav e s and activat e s coniguration changes, shuts down 
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data collection, runs CM/2 settup, and runs LAPS. 

Shuting down data collection, running CM/2 settup, and 

LAPS require seperate timers. 

5 RETURNS: RC OK if succoofull, RC ERROR if not sucessfal 

1 otherwise 

REVISIONS: 
DATE — NAME — DESCRIPTION 

10 

12/01/97 D.Hughes INITIAL REVISION 

**/ 
15 /* 

SaveAndActivate() 

it/ 

LONG SavoAndActivato( VOID ) 

4 

20 copy new default files. 

initiat e stop data collection. 
While(not stopped || timed out) 

-4 

25 sle e p 1 second 

counter ++ 

test to see if data collection is stopped 

if(data collection is stopped) 

stopped ~ TRUE; 

30 else if (counter — MAX TIME^STOP) 
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time out - TRUE 

-4 

if(tim e d out) 
kill dcm 

5 

counter ~ 0; 

tim e out ~ FALSE; 

initiated CM/2 

While(not finished | | timed out) 

io -4 

sleep 6 seconds 

count e r ++ 

t e st to see if CM/2 is finished 

if(CM/2 is fini s hed) 

15 finished ~ TRUE; 

els e if (counter — MAX_FINISH_TIME) 

time out - TRUE 

if(timed out) 
20 return RCJ5RROR 

counter ~ 0; 
time out ~ FALSE; 
initiated LAPS 
25 Whil e (not finished [ | timed out) 

sleep 6 seconds 

counter i I 

t e st to see if LAPS is finished 

30 if(LAPS is finished) 
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fini s hed ~ TRUE; 

ol so if (count e r — MAX_LAPS_FIMISH_TIME) 

timo_out-TRUE 

5 if(timed out) 

return RCERROR 

r e turn RC OK 
I 

10 

1.2.8.1. 7. 1.2.Increment Phase 
*** 

15 FUNCTION: IncrementPhase 

AUTHOR: D. Hugh e s 

DESCRIPTION: — Increm e nts th e current phas e number in the upgrad.log file 

RETURNS: The new phase number if successfully set 

1 otherwi s e 

20 

REVISIONS: 
DATE — NAME — DESCRIPTION 



08/21/97 D.Hughes INITIAL REVISION 

25 

********************************** 
**/ 

IncrementPhas e Q 
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LONG [ncremontPhasc( VOID ) 

i 

CHAR s zPhasoNumb o r[35]; 
LONG lPhaoc-Q; 

lPhase FindValue(log file path, PHASE, PHASE); /* determine the phase 
numb e r */ 

_ltoa(lPhase+ 1 , szPhas e N umb e r, 1 0); 

if(SearchAndAddStringtoFil e (pszFileNam e Path, 

PHASE,PHASE, 

szPhaseNumbor) — RC_OK) 

-4 

return ++lPhase; 

-4 

return 1 ; 

f 

1.2.8A7.1.3.DiskSizo 

% % 

FUNCTION: DiskSize 

AUTHOR: P. Hughes 

DESCRIPTION: Finds tho size of the hard driv e 
RETURNS: Siz e of th o hard drive 

REVISIONS: 
DATE — NAME — DESCRIPTION 
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08/08/97 D.Hugh e o INITIAL REVISION 

5 m 

Di s kSize() 

H ■ 

LONG DiokSize( void ) 
10 i 

APIRET rc - NO ERROR; 
FILE* pfDioklmagoFilo ~ NULL; 

15 

HFILE hfDiokFIleHandlo - 0; /* handle to C: drive */ 

CHAR BzFileNomo[20] ~ "C:"; 
PCHAR pszFileName; 

ULONG ul Action; /* paramters for DOSOPEN */ 

20 ULONG ulCbFilo - 0; /* H 

ULONG ulAttributo - 0; /* H 

ULONG ulFoOponFlago ~ 0; — /* */ 

ULONG ulFsOponMode ~ 0; /* */ 

25 UCHAR uchLockParam - 0; /* parameter for IOCTL lock */ 

UCHAR uchLockData - 0; /* data for IOCTL lock H 

— ULONG ulLockParamL e nMax; — /* Max l e ngth of param sent IOCTL H 

ULONG ulLoclcPlength; /* length of parameter oont IOCTL H 

— PULONG pulLockParmL e n;/* point e r l e ngth of param s e nt IOCTL H 

30 — PVOID pLockParamo; 
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ULONG ulParamLenMax - 0; /* Max l e ngth of param sent IOCTL */ 

— PULONG pulPannLen; /* pointer length of param sent IOCTL H 

ULONG ulPLength - 0; /* l e ngth of parameter sent IOCTL */ 

5 

ULONG ulDataL o nMax ~ 0; /* Max l e ngth of data sent IOCTL */ 

PULONG pulDataL e n; /* pointer l e ngth of data sent IOCTL */ 

ULONG ulDLength - 0; /* l e ngth of data s ent IOCTL */ 

— APIRET ulrc; /* r e turn cod e 

10 UCHARuchParms[120]; 

— struct Parameters Params; — /* parameters structure for IOCTL H 

— struct Parameters* pParams; /* pointer to parameters structure for IOCTL */ 

struct DeviceParams D e vParms;/* device structure for IOCTL H 

15 struct D e viceParams* pD e viceParams;/* pointer to device structure for IOCTL*/ 

— pszFileName - szFileName; 

— pParams - malloc(sizeof(Params)); 
20 — pD e viceParams malloc(siz e of(DevParms)); 

— pulDataLen ~ &ulDLength; 

ulCbFil o - 100L; 
25 — ulAttribute - 0L; 

— ulFsOp e nFlags ~ 1 L; 

ulFsOpcnMode ~ OPENFLAGSWRITETHROUGH [ 

OP EN_S H A REDEN Y RE A D W RITE | 

OPENFLAGSNOINHERIT | 

30 OPENJFLAGSJDASD; 
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/* Get a handle for disk driv e C: */ 
— rc ~ DosOpen(pszFileName, 
MfDiskFIloHandlo, 

5 &ulAction, 

ulCbFile, 

ulAttribute, 

ulFsOp e nFlags, 

ulFsOp e nMode, 

10 : NULL 

H 



— if(rc !-NO_ERROR) 

— 4 

15 exit(O); 



/* lock everyone out from access to driv e */ 



20 — ulLockParamLenMax sizeof ( uchParm s ); 

— ulLockPlength-O; 

- — pulLockParmL e n ~ &ulLockPlength; 

— pLockParams ~ &uchLockParam; 

— ulLockPl e ngth - siz e of(uchLockParam); 
25 — ulDLength ~ sizeof(uchLockData); 

ulrc - DosDevIOCtl(hfDiskFlleHandle ? 

IOCTL_DISK, 

DSK_LOCKDRIVE, 

30 &uchLockParam, 
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ulLockPl e ngth, 



&ulLockPlength, 



&uchLockData, 



ulDL e ngth, 



&ulDLongth 



if(ulrc !~NO_ERROR) 

-4 



10 exit(0); 

— ulPLength ~ sizeof(Params); 

— ulDLength ~ sizeof(sizeof(DevParms)); 
15 — Params.ucCommand info ~ 0x01; 

— Params.ucDriv e info ~ 0x02; 

ulrc ~ DosDcvIOCtl(hfDiskFIlcHandle, 

IOCTLDISK, 

DSKGETDEVICEPARAMS, 

20 pParams, 

ulPLength, 

&ulPLongth, 



pD e vio e Params, 



ulDL e ngth, 



25 &ulDLongth 



— if(ulro !-NO_ERROR) 
e xit(O); 



30 — f 
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/* releas e lock on driv e c: */ 



— ulLoolcParamLenMax " siz e of(uchParms); 
5 — ulLockPlength - 0; 

— pulLockParmLen &ulLockPlength; 
— pLockParams ~ &uchLockParam; 
— ulLockPl e ngth siz e of(uchLockParam); 
— ulDLength - sizeof(uchLockData); 

10 

ulrc - DosDevIOCtl(hfDislcFllcHQndle, 

IOCTLJDISK, 

DSKUNLOCKDRIVE, 

&uchLockParam, 

15 ulLockPlength, 

&ulLookPlength, 

&uchLockData, 

ulDLength, 

&ulDLength 

20 )t 

— /* releas e the handle to drive c: */ 
re ~ DosClo G c(hfDiskFIleHandle); 
— f el o s e(pfDi sk I rn age F i 1 e ) ; 

2S 

return pDeviceParams >Num_Cylinders; 

) /* e nd ofDiskSiz e O */ 
1.2.8.1.7. 1 APhaseZero 
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* NAME: PhaseZero 

5 * DESCRIPTION; Tests to see if tho zip filos are valid 

* ASSUMPTIONS: 

* 

10 -* 

* REVISION HISTORY: 

it 

4 Date Author Description 

± 

15 * — 08/08/97 Doug Hughe s Original code 

PhaseZero() 
i 

_/* 

20 check to see if a valid os_driv e .zip e xists. The upgrad e .ini files 

in each zip file should be identical. The test here is if the zip 

fil e is valid. It is valid if it contains a upgrade.ini 

n 

if (os_drive.zip exists) 

25 { 

unzip q os_driv e .zip upgrade.ini 

if( upgrade.ini exists) 

{ 

/* 

30 Check to s ee if upgrad e .ini is valid. Compar e ini version to 
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20 



upgrade.exe version 



if ( ilni Level !~ iExeLev e l) 



put error messag e to upgrad e .log 



exit(0) 



10 rename upgrade.ini to temp.ini for test on 

nextgen_drive.zip 

n 



rename upgi'ade.ini to temp.ini 



4 



15 eke 

{ 



log error — invalid os__drive.zip 



-exit 



) /* end of if os drive.zip exists */ 



if (nextgen_drive.zip e xists) 

{ 

25 unzip nextg e ndrive.zip upgrade.ini 

if( upgrad e .ini exists) 

1 

/i 

Ch e ck to s ee if upgrad e .ini is valid. Compar e ini v e rsion to 

30 upgrad e . e x e version 
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if ( i In i L e vel !~ i Ex e Level) 
{ 



put e rror message to upgrad e .log 



exit(O) 



— rename upgrad e .ini to temp.ini for test on 



10 boot _driv e .zip 

*/ 



rename upgrade.ini to temp.ini 



-else 



15 { 

log error — invalid n e xtgen_drive.zip 



20 ) /* end of if nextg e n_drive.zip exists */ 



if ( bootdriv e .zip exists) 



i 

unzip boot driv e .zip upgrade.ini 

25 if( upgrade.ini exists) 

[ 

/* 



Ch e ck to s ee if upgrad e .ini is valid. Compar e ini v e rsion to 
upgrad e . e x e v e rsion 



30 n 
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if ( ilniLevel !~~ iExeL e vel) 



-f 

put error message to upgrad e .log 



exit(O) 



-else 



[ 

log e rror — invalid boot_drive.zip 

10 exit 



] /* end ofifboot_drive.zip exists */ 

15 if ( upgrade.ini does not exist && tmp.ini does) 

r 



T e mp.ini exists and upgrad e .ini does not exist 



20 copy temp.ini upgrade.ini 

} 

if (upgrade.ini does not exist) 

r 



25 R e port e rror — no valid zip fil e 

exit 

{ 



-else 



i 

30 read version number from upgrade.ini 
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read version number from DCS 300 

compar e th e DCS 300 softwar e version to the version controll e r in 
upgrade, i ni 



if ( th e DCS 300 softwar e v e rsion is not in v e rsion controll e r) 
— log error message to upgrade.log 



quit upgrad e 



10 open upgrade.ini; 

read in upgrade type to pszUpgradeType; 

if( pszUpgradeType — Minor) 

e 

iUpgradeType ~ 0; 

15 } 

if(strcmp( pszUpgradeType,REBOOT)) 

{ 

iUpgradeType - 1 ; 



*■ 

20 if(strcmp(pozUpgradoTypc,SHUTDOWN)) 

{ 

iUpgrad e Type ~~ 2; 

} 



if( strcmp(pszUpgrad e Typ e ? SEVERE)) 

25 { 

iUpgrad e Typ e ~ 3; 

} 



if (i UpgradoTypo,S EVERE)) 



30 { 
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/* 

Find the size 

of th e hard driv e 

and log it. 

5 n 

IDiskSiz o ~ DiskSizcO; 

_ltoa(lDiskSize, szPhaseN umber, 1 0); 



S e archAndAddStringtoFile (pszFileNam e Path, 

10 DISKSIZE, DISKSIZE, 

IDiskSize) 

read in the additional paramet e rs from upgradet.ini; 

make sure that the partition names are for the appropriate disk 

siz e using IDiskSiz e ; 



15 y 

if(iUpgradeTypo — SHUTDOWN) 

{ 

read in the additional parameters from upgrad e .ini 

y 



20 if (iUpgradoType — REBOOT | | iUpgradoT>po — SEVERE) 

/* get the list of system files to backup */ 

if ( os_drive.zip exi s ts) 



[ 

oxtract UPGDBKUP from zip fil e 

25 f 

else if (nextgen.zip e xists) 



4 

— e xtract UPGDBKUP from n e xtg e n.zip fil e 



} 

30 e ls e if (boot.zip e xists 
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{ 

extract UPGDBKUP from boot.zip file 

r 

else 

5 { 

log error — no valid zip file 

qwt 

} 

) /* end of get system file backup list */ 

0 

/* no problems with *.zip and upgrade.ini. — */ 

/* also, no problems with version numbers. */ 

/* Proceed with the upgrade .... */ 



15 log success message to upgrade.log 

if (chParamet e r — 'q ? ) 



4 

— /* a query of the upgrade was mad e */ 
— exit 



20 f 

if (RJpgradoType — SEVERE) 

/* Skip to phas e 1 */ 



-f 

— phas e ~ 1 ; 



25 writ e phase to log file 

oloo if (iUpgradoTypo — REBOOT) 

/* Skip to phas e A */ 



4 



30 phas e ~ 4; 
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writ e phase to log file 

} 

else 

{ 

5 /* MINOR or SHUTDOWN upgrade ♦/ 

phas e ~ 5; 

writ e phase to log file; 

} 

} 

10 r e turn; 

} 

1.2.8A7.1.5.PhaseOne 

15 * NAME: PhaseOne 

* DESCRIPTION: Delete boot partition, Create boot partition 
* delete/create boot manager 

20 * ASSUMPTIONS: 

it 

* REVISION HISTORY: 
25 * 

4 — Date Author Description 

* 

* — 08/08/97 Doug Hughes Original code 
it 
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PhaseOne() 
i 

/* 

sav e the type of video 

driver to upgrad.ini 

— n 

Sav e VideoType() 

if(fiSaveActivat e ) 

— { 

check to see if save and activate is necessary 

if (save and activated needed) 

{ 

IRC ~ Sav e AndActivatcO; 

if (IRC !~RC_OK) 

{ 

Log error message to log file 

} 

} 

— } 

ch e ck to s ee if mh qu e e xists 

if(mh que exist) 

( 

/* shut down data collection if it is running */ 

Shut down data coll e ction. 

loop testing to s ee if mh que still e xists 

if doesn't exist, quit looping. If still e xist, 
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wait T B O tim e and th e n stop looping, 

If timed out, kill dcm. 

— f 

if(OS — 1) 

5 f 

extract UPGDBKUP from zip fil e 

IRe ~ SystemBaclcup(d:\upgrade); 

if( IRo !~ RC_OK ) 

10 { 

printf( SYSTEM_BACKUP_ERR); 

printf( "%ld", IRe ); 

exit(0); 

) // end if 

15 

IRo ~ CreateUpgradeTmpFile(d:\upgrade); 

if( IRe !~ RC OK ) 

{ 

printf(UPGRAD_TMP_FILE_ERR ); 

20 oxit(0); 

} 

) /* end if OS — 1 */ 

if(BOOT_MANAGER — 1) 

25 { 

creat e boot manager 

if(BOOT — 1 ) 

{ 
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deleted 

H 

if(!strcmp(pszSwapperPartitionName ? NULL)) 

i 

— lRc ~ DeletePartitions(pszSwapperPartitionNam e ); 
if (IRC !~ NOERROR) 

exit(O); 

) /*cnd if*/ 



— delete the boot partition 
if(!strcmp(pszBootPartitionName,NULL)) 

-f 

lRc ~ DeletePartitions(pszBootPartitionName); 

if (IRC !-NO_ERROR) 

— [ 

exit(O); 

— ) /*end if*/ 

-+ 

if(lBootPartitionSizo !~ 0) 
4 

— lRc - Cr e at e _Partition(lBootPartitionSize, 

iBootPartitionType, 

iBootPartitionStartablo, 
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pszBootPartitionFS, 

chBootPartitionStart 

)t 

if (IRC !-NO_ERROR) 

5 { 

oxit(O); 

) /* end if*/ 

} 

) /* ond if BOOT_PARTlTION_CHANGED */ 

10 

CLEAR_SCREEN; 

printf(PHASE_MSG, lPhaoo, lPhase + 1); 

fflush(stdout); 

lPhase ~ Increm e ntPhaseO; 

15 

if(BOOT ~- 1) 

[ 

Copy new config.sys and new startup.cmd; 

/* reboot to activate fdisk changes */ 

20 reboot to c drive 

] /* ond if BOOT_PARTITION_CHANGED */ 

) /* e nd if phase 1 */ 

25 Return; 

f 

1.2.8.1. 7. L6.PhaseTwo 
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** 
it 

* NAME: PhaseTwo 

5 * 

* DESCRIPTION: — Format boot partition, d e lete/creat e swapper 

* OS and/or nextg e n partitions copy boot drive 

-* operating system files. 

_i 

10 * ASSUMPTIONS: 

± 

* REVISION HISTORY: 
15 * 

* — ©ate Author D e scription 

ifc 

* — 08/08/97 — Doug Hughes Original code 
± 

PhaseTwo() 

i 

read in the additional paramet e rs from upgradet.ini; 

mak e sure that th e partition names ar e for th e appropriat e disk 

25 size using IDiskSize; 

if(BOOT— 1 && !strcmp(pszBootFil o Systom,NULL)) 

{ 

FormatPartition(psz BootFil e Syst e m); 

30 unzip bootpart.zip into th e boot partition 
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copy upgrad e .log from d:\ugprade to f: drive 

copy over backup system fil e s from d:\upgrad e to f: driv e 

— } 

if(BOOT !~ 1 

5 && SWAPPER — 1 && 

strcmp(pszSwapperPartiti onN ame, NU LL)) 

c 

/* 

delete the swapper partition 

10 */ 

IRe ~ DeletePartitions(szSwapp e rPartitionNam e ); 

if (IRC !- NO_ERROR) 

t 

Bxit(0); 

15 ) /* end if*/ 

) /* end if BOOT !~ 1 SWAPPER — 1 && 

!pszSwapp e rPartitionNam e ~ NULL */ 

if(OS — 1 && 

20 !strcmp(pszOSPartitionName, NULL) ) 

r 

/* 

d e lete the os partition. 

*/ 

25 IRe ~ DeletePartitions(pszOSPartitionNam e ); 

if (IRC !-NO_ERROR) 

{ 

exit(0); 

) /♦ end if*/ 

30 ) /* end if OS — 1 && pszOSPartitionNamo !~ NULL ♦/ 
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if(NEXTGEN ~- 1 && 

!strcmp(pszNextgenPartitionName, NULL) ) 

[ 

5 /* 

del e te the n e xtgen partition 

n 

lRc ~ D e letePartitions(pszNextg e nPartitionNam e ); 

if (IRC !~NO_ERROR) 

10 { 

e xit(0); 

) /* ondif*/ 

) /* end if NEXTGEN — 1 && p s zNoxtgenPartitionName!- NULL */ 

if(SWAPPER — 1 && 
lSwapperPartitionSize !~ 0 ) 

i 

lRc - Create_Partition(lSwapp e rPartitionSize, 

iSwapperPartitionType, 

iSwapp e rPartitionStartable, 

pszSwapperPartitionFS, 

chSwapperPartitionStart 

H 

if (IRC !~ NO ERROR) 

-t 

exit(0 ) ; 

] /♦ end if ♦/ 

) /♦ end if SWAPPER — 1 && lSwapporPartitionSizo !~ 0 ♦/ 
30 if(OS — 1 && 



20 
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i 

IRo ~ Create_Partition(10SPartitionSize, 

iOSPartitionT>pe, 

iOSPartitionStartable, 

pszOSPartitionFS, 

chOSPartitionStart 



if (IRC !-NO_ERROR) 

-{ 

exit(O); 

) /* end if*/ 

) /* ond if OS — 1 && lOSPartitionSizo !~ 0*/ 

if(NEXTGEN — 1 && 

lN e xtgenPartitionSiz e !~ 0 

-) 

4 

— IRe Creat e Partition(lNextgenPartitionSize ? 

iNextgenPartitionType, 

iNextgenPartitionStartable, 

pszN e xtgenrPartitionFS, 

chNextgenPartitionStart 

H 

if (IRC !~NO_ERROR) 

o xit(0); 

) /* ond if */ 
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) /* ond if NEXTGEN — 1 && lOSPartitionSizo !~ 0 */ 



increment phas e in upgrade.log on f: driv e to phase 3 

5 if(NEXTGEN — 1 | | 

OS— 1 || 

SWAPPER — I) 

{ 

fdisk /IBD:BOOT_DRIVE; 

10 } 

— Return; 

I 

15 1.2.8.1.7.1.7-PhaseThrec 

* NAME: PhaseThree 

20 * DESCRIPTION: Format boot partition, delete/create swapper 
■* OS and/or nextgen partitions 

* ASSUMPTIONS: 

25 ifc 

* REVISION HISTORY: 

* — Bate Author Description 
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* — 08/08/97 — Doug Hughes — Original cod e 

5 Phas e Three() 

if (!otrcmp(pozOSPartitionFS, NULL) 

FormatPartition(C_DRlVE,pszOSPartitionFS); 

10 — ) /* end if p s zOSPartition !~ NULL ♦/ 

— if (!strcmp(pszNextgenPartitionFS, NULL) 
— t 

FonnatPartition(D_DRIVE,pszN e xtg e nPartitionFS); 

15 — ) /* end if pszN e xtg e nPartition !~ NULL */ 

— if (!strcmp(pszSwapperPartitioiiFS, NULL) 

—4 

FormatPartition(D_DRIVE,pszSwapperPartitionFS); 

20 — ) /* end if pszSwapperPartition !~ NULL */ 

— increm e nt phas e in upgrad e .log to phase 5 
— Return; 

25 L2.8^.7.1.8.Pha s eFour 

* NAME: PhaseFour 



[11041 8 265A16 8 959j,POC] 



* DESCRIPTION: PhasoFour is for REBOOT upgrades. It does 

* A sav e and activate and r e boot to the alternate 

* operating system 

* ASSUMPTIONS: 
5 * 

± 

* REVISION HISTORY: 

10 4 — Date Author Description 

* 

* — 08/08/97 — Doug Hughes Original code 

15 / 

PhaseFour() 

— if(fSaveActivate) 

— { 

20 check to see if save and activate i s n e cessary 

if (save and activated needed) 

1 

IRC ~ SavaAndActivate(); 

if (IRC !- RCOK) 

25 { 

Log e rror mes s age to log fil e 

} 

} 

— } 



[11011 8 265A16 g 0.'i9J.DOC] 



96 



ch e ck to see if mh que e xists 

if(mh qu e exist) 

— ( 

/* shut down data coll e ction if it i s running */ 

5 Shut down data collection. 

loop t e sting to see if mh que still e xists 

if doesn't exist, quit looping. If still exist, 

wait TBP time and then stop looping. 

If timed out, kill dcm. 

10 f 

fdi s k /IBD:BOOT_DRIVE 

return 

15 | 

1.2.SA7.1.9.PhaseFive 

20 * NAME: PhaseFive 

* DESCRIPTION: — For r e boot upgrad e s, a system backup is don e . 
-* For all upgrad e s, th e zip files ar e unzipped. 

* For the reboot and s e v e r e upgrades, the system 

25 * configuration is restored 

* ASSUMPTIONS: 

± 
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* REVISION HISTORY: 

± 

4 — Bate Author Description 

± 

5 * — 08/08/97 Doug Hughes Original cod e 

**/ 

PhaseFive() 

4 

10 

if (iUpgradeType — SHUTDOWN) 

/* this is an upgrade primarily of th e n e xtgen directory */ 

r 

// Shutdown nextgen processes (dcm stop?) 

15 j-^ 

This will not be implement e d until th e DCS 300 

migrates to Windows NT 

n 

— } 

20 

if (iUpgradeTypc — REBOOT) 

/* 

Usually a Major upgrade of c: driv e — n e ed to back up syst e m 

fil e s, run cr e at_ng 

25 — n 
— { 

SaveVideoType() 

extract UPGDBKUP from zip fil e 

30 IRc ~ SystemBackup(d:\upgrade); 
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if( lRc !~ RC_OK ) 

[ 

printf( SYSTEM BACKUP ERR); 

5 printf( "%ld", lRc ); 

e xit(O); 

] // end if 

IRo ~ Cr e at e Upgrad e TmpFile(d:\upgrade); 

10 if( lRc !~ RC_OK ) 

{ 

printf(UPGRAD_TMP_FILE_ERR ); 

e xit(O); 

} 

15 ] /* end of if REBOOT*/ 

CLEARSCREEN; 

printf( WOR KIN G_M S G) ; 

fflush(stdout); 

20 

— U 

// Copy D: drive from CD ROM 

U 

25 U — Make sure w e ar e on the D drive 

U 

lRc - Do s SetDefaultDisk( 1 ); // Set to th e D drive (1~A,2-B,...) 

if( lRc !- RC OK ) 

{ 

30 pri ntf( SETTI"N G_DRI VE_ERR) ; 
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printf("%d", IRo); 

exit(O); 

// Mov e to th e root directory 

5 lRc ~ DooSctCurrcntDir("\\"); 

printf(COPY_SYSTEM_FILES_INFO); 

lRc ~ DooExccPgmWrapper(UNZlP_EXE, D1MAGE); 

10 if (IRC !-NO_ERROR) 

f 

printf(UNZl P IN G_F I LE STODE RR) ; 

e xit(0); 

) // ond if 

15 

U- — Mak e sure we ar e on the C driv e 

U 

lRc - DosSotDofaultDisk( 3 ); // S e t to the C drive (1-A.2-B,...) 

if( lRc !~ RC_OK ) 

20 { 

printf(SETTING_DRIVE_ERR); 

printf("%d", IRo); 

e xit(0); 

f 

25 // Move to th e root directory 

lRc ~ DosSetCurrentDir("\\"); 

lRc ~ DosExocPgm Wrapp o r(UNZIP_EXE, C IMAGE); 

if (IRC !~ NOERROR) 

30 { 
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printf(UNZIPING_FlLES_TO_C_ERR); 

exit(O); 

) // end if 

5 if iUpgrad e Type — SHUTDOWN) 

/* this is an upgrad e primarily of the nextgen directory */ 

r 

T-SO 

R e start n e xtgen process e s (dcm start?) 

10 -H- 

if (iUpgradeType — REBOOT [| iUpgradeType — SEVERE ) 

r 

// Before running creat_ng, copy upgrad e temp fil e 

// from d:\ugprad e driv e to location wher e creat_ng looks for 

#4*7 

20 memset(szSysCmdStr,NUL, 

NG BUF IN LEN + NG BUF IN LEN +2); 

sprintf(szSysCmdStr,"%o%s%c%s%o%s %s%c%g%s%o", 

COPY_COMMAND, 

25 EDRIVE, 

OSCHARDIR, 

UPGRADE DIR, // Where we s aved it 

OSCHARDIR, 

DEFAULT_NG_TEMP_UPGRAD_FILE, 

30 KhJOW>j_NG_SYS_INI_PATH, // whoro it noods 
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5 



to b e 

OSCHAR_DIR, 



D E F A U LTN G_T E M P_U PG R A D_F 1 L E, 



R E D [R ECT_OUTP UT, N U L_F [L E) ; // keep it quiet 



iSysR e turn ~ syst e m(szSysCmdStr); 



if(iSysRoturn<0) 



4 



10 /* try a DosCopy, s e e if that works 

* it will giv e us b e tt e r error r e turn code 

n 

oprintf(szSyoCmdStr,"%s%c%a%c%o", E DR1VE, 

OSCHAR DIR. 



15 UPGRADEDIR, // Where we saved it 

OSCHARD1R, 

DEFAULT_NG_TEMP_UPGRAD_F1LE); 

// wh e re it n e eds to b e 

20 sprintf(szFileNam e Path, "%q%c%q", KNOWN_NG_SYSJNI_PATH, 

OSCHAR_DIR > 

DEFAULT_NG_TEMP_UPGRAD_F1LE); 

iSysR e turn ~ DosCopy(szSysCmdStr, szFil e Nam e Path, 0L); 

25 if(iSyoR e turn !~ 0) 

{ 

sprintf(szErrorOut,"^ o S^y 0 s\ny o S %o\nError Co&q:%<M>/ * q" , 

ERROR_HEADING_300_D, 

COPY ERR, 



30 szSysCmdStr, szFil e Nam e Path, 
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iSy s R e turn, 

CONTACTINTERSUPPORT); 



printf(''\n\n%s\n\n'',szErrorOut); 

5 exit(O); 

} 

) // end if 

U- — Make sure w e ar e on the d:: driv e 

10 U 

IRe ~ DooSetDefaultDisk(l); // Sot to the f: drive (1-\,2-B,...) 

if(lRc !~RC_OK) 

{ 

pri ntf( SETT1N GDR [V EE RR) ; 

15 printf("%d", IRe); 

e xit(0); 

r 

// now call creat_ng to update the configuration 

IRe - DosExecPgmWrapper(CREAT^NG_EXE, ""); 

20 

if(lRc!-RC_OK) 

(// If failure her e , we expect creating would have listed 

errors on its own. 

25 printf( "Vntormcodpid ~ %ld, rosultcodo - %ld M , 

ChildRC.codoTorminato, ChildRC.codeResult ); 

e xit(0); 

} 

30 
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// restor e back e d up syst e m files 

IRo - Syst e m R e s tore(d:\upgrad e ); 

5 

CLEAR_SCREEN; 

printf(WORKlNG MSG); 

fflu s h(stdout); 

// Restore old TCPIP start command to config.sys file. 

if (EnableTcpipInConfigSysQ !~ RCJ3K) 

[ 

15 exit(O); 

} 

// Restore old HOSTNAME to config.sys file. 

20 HostNameRestore(f:\upgrad e ); // Don't check return code, 

// always returns OK 

/* copies the correct drivers for the video card */ 

CopyVideoDriv e rs(); 

25 

/* 

put s the correct lines in config.sys and 

config.ngc for the video card 

n 

30 FixVideoInConfigSy s Q; 
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) /* ond if REBOOT | | SEVERE ♦/ 



if (REBOOT |1 SEVERE) 

5 -4 

fdisk /startabl /namex 

/* force reboot to c: drive*/ 

fdisk /ibd:o; 

— h 

10 

return 

1.2.8.1.7. 1.1 0.SavoVideoType 

\ 5 ^ ^ ^ ^ ^ 

* NAME: SaveVideoType 

* DESCRIPTION: — Finds the type of video driv e rs in config.sys and 
-* stores the value in upgrade.log 

20 * ASSUMPTIONS: 

± 

* REVISION HISTORY: 
25 * 

4 Bate Author Description 

* 

* — 08/08/97 — Doug Hughe s — Original code 
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Sav e VideoType() 

i 

detect type of video card 

search config.sys for VIDEODEV1CE 

5 on same line look for VIO SVGA or VIOVGA 

Store th e result in upgrade.log 

use old find value. 

r e sult 

I 

10 1.2.8.1 .7. 1 . 1 1 .CopyVideoDrivers 

* NAME: CopyVid e oDrivers 
± 

15 * DESCRIPTION: Copies the Video Driv e rs to the c:\os2\dll and 
-* C:\os2\mdos directories 

* ASSUMPTIONS: — booted from the alternate boot driv e 
it 

± 

20 

* REVISION HISTORY: 

* — Date Author Description 

% 

25 * — 08/08/97 Doug Hughes Original code 
CopyVideoDrivers() 

{ 

Read vid e o typ e from upgrade.log 
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if( vid o otypo — SVGA) 

r 

copy thes e files from the SVGA directory to the c:\os2\dll directory: 

BVHSVGA.DLL 

5 BVHVGA.DLL 

1BMDEV32.DLL 

IBMVGA32.DLL 

copy VSVGA.SYS from tho SVGA directory to tho c:\os2\mdos 

dir e ctory. 

10 -4 

— if( videotype — VGA) 
— r 

copy these files from the VGA directory to the c:\os2\dll directory: 

BVHSVGA.DLL 

15 BVHVGA.DLL 

1BMDEV32.DLL 

1BMVGA32.DLL 

copy VSVGA.SYS from the SVGA directory to th o c:\os2\mdos 

— directory. 

20 } 

I 

FixVideoInConfigSys() 
25 $ *E ft 

* NAME: FixVideoInConfigSys() 

* DESCRIPTION: — Fixes th e s e ttings in config.sys for th e video 
30 * ASSUMPTIONS: nono 



[11011 8 265A16 8 959J.DOC] 



it 

£ 

* REVISION HISTORY: 

5 * 

4 — Date Author Description 

* 

* — 08/08/97 Doug Hughes Original code 

10 FixVideoInConfigSys() 

i 

R e ad video typ e from upgrad e .log 

if( videotyp e — SVGA) 

{ 

15 copy SVGA lines to config.sys and config.ngc 

— } 

if( vid e otyp e — VGA) 

f 

20 copy VGA lines to config.sys and config.ngc 

— } 

1 .2.8.1 .7. 1 . 1 2.DolotoPartitions 

* NAME: Delet e Partitions 

* DESCRIPTION: dolotcs c and d partitions 
it 
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* ASSUMPTIONS: 

£ 

5 * REVISION HISTORY: 

4 — Bate Author Description 

± 

* — 08/08/97 Doug Hughes Original cod e 

/ 
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Delet e Partitions() 
H 

LONG DelctePartitions ( 
PCHAR pozDi s kNam e 

i 

LONG IRC ~ 0; 

CHAR szSysCmdStr[NG_BUF_!N_LEN + N G_B UF IN LEN +2]; /* for sy s tem — *^ 

/* copy command — */ 

CHAR s zErrorOut[MAX_ERROR_OUT_LEN +1]; /* for e rror output strings */ 
INT iSysR e turn ~ 0; /* for return from system call */ 

The Partition nam e s are diff e rent for the 510Meg, 2.2 Gig, 

and 2.5 Gig drives 

— */ 

memset(szSygCmdStr,NUL,NG_BUF_IN_LEN + NG_BUF_IN_LEN +2); 

oprintf(ozSyoCmdStr,"%o%fl%o%o%B w > FDISK_COMMAND, DE LETECO M M AN D, 

pszDislcNam e , 

REDIRECT OUTPUT, NUL FILE); 

iSysReturn ~ system(szSysCmdStr); 

if(iSyoRoturn<0) 

c 

IRC- 1; 
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sprintf(szErrorOut,''VoG\n% s \nro s \n%G'',ERROR_HEADlNG_300_D,DELETE_DRIVE_E 
RRj 

5 szSysCmdStr, 

CONTACT JNTERJgUPPORT); 

printf("\n\ny 0 oWji",GzErrorOut); 

fflush(otdout); 

10 

) /*end if*/ 



return IRC; 
15 ) /* end of DeletePartitionsQ */ 
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1.2.8.1.7.1.13 .FormatPartitions 

♦ NAME: FormatPartition 

5 * DESCRIPTION: format passed in drive nam e 

♦ ASSUMPTIONS: 

& 

10 * 

♦ REVISION HISTORY: 

4 — Bate Author Description 

i£ 

15 * — 08/08/97 — Doug Hughes Original cod e 

* — 08/22/97 D. Kaatz/D.H. Made more generic; pa s s in drive to part. 

*****/ 

20 /* 

FormatPartitionQ 
*/ 

LONG FormatPartition (PCHAR p s zDriv e , PCHAR pszFiloSystom) 
i 

25 LONG IRC ~ 0; 

CHAR sz Sy sCm d S tr[N G_BUF_IN_LEN + NG_BUF IN LEN +2]; /* for syst e m 

*/ 

/* command commands */ 

CHAR szErrorOut[MAX_ERROR_OUT_LEN + I]; /* for error output strings */ 
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INT iSysRoturn - 0; 



/* for return from syst e m call — */ 



/* format driv e */ 

5 m e mset(szSyoCmdStr,NUL,NG_BUF_lN_LEN + NG_BUF_1N_LEN +2); 
oprintf(szSy o CmdStr,"%s% s %s%s%s%g%s", 

FORMATCOMMAND, pszDrive, 

pszFileSyst e m, 

REDIRECT INPUT, 

10 INPUT_FILE, 

REDIRECTOUTPUT, 

NULFILE); 

iSysReturn ~ syst e m(szSysCmdStr); 

15 

if(iSysReturn<0) 
-r 

IRC- 1; 

20 oprintf(azErrorOut,"y o O^%G\n%^jir 0 o", 

ERROR_HEADING_300_D, 

FORMAT DRIVE ERR, 

szSysCmdStr, 

CONTACTINTERSUP PORT) ; 

25 

printf("\n\ny 0 s \n\n", s zErrorOut); 

ffluoh(otdout); 

) /* ond if*/ 

30 
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return IRC; 
) — /* end FormatPartitions() */ 

1 .2.8.1 .7. 1 . 1 <\ .Cr o atePartitions 

5 * NAME: CreatePartitions 

* DESCRIPTION: Creates now partition 

* ASSUMPTIONS: 
10 * 

J 

* REVISION HISTORY: 

it 

15 * Date Author Description 

& 

— 1 1/12/97 Doug Hughes — Original cod e 

it 

20 

PL 

CreatePartitions() 
*/ 

LONG CreatePartitions( 

25 LONG IDiskSizo, 

LONG ITypo, 

INT iStartable, 

PSZCHAR pszFiloSystem, 

CHAR cStart 
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i 

LONG IRC ~ 0; 

CHAR szSyoCmdStr[NG_BUF IN LEN + NGBU FINLEN +2]; /* for 
syst e m copy command — */ 

CHAR ozErrorOut[MAX_ERROR_OUT_LEN + 1]; /* for e rror output 
strings — */ 

INT iSysR e tum - 0; /* for return from syst e m call */ 

aprintf(szSyiK:mdStr/'%g%B%B%B%a%o%a%B%fl%fl%oyBo" t 

FDISKCOMMAND, 

CREATE COMMAND, 

FSTYPE, pszFileSyotem, 

VTYPE, lTyp e , 

D1SKSIZE, IDiskSize, 

START, cStar, 

REDIRECTOUTPUT, 

NULFILE); 

iSysRetum ~ syst e m(szSysCmdStr); 

if (iSysRetum < 0) 

c 

IRC- 1; 

oprintf(szErrorOut,"y 0 s\ny 0 s\ny ( . o\ny o o",ERROR_HEADING_300_D, 

CREATEDR1VEERR, 

szSysCmdStr, 

CONTACTINTERSUPPORT); 
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printf( M \n\n%s\n\n" ? szErrorOut); 
fflush(stdout); 



) /* e nd if*/ 

5 

return IRC; 

) /* end of CreatePartitions() */ 
1.2.8A7.1.15.FindValu e 

10 

* NAME: FindValue 

it 

15 * DESCRIPTION: — find value of input string in a file under 

4 specified section 

it 

* ASSUMPTIONS: none 

20 * 

it 

* REVISION HISTORY: 

it 

4 — Bate Author Description 

25 £ 

* — 08/08/97 Doug Hugh e s — Original code 
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FindValue() 
*/ 

LONG FindValue ( 

5 PSZ pszFiloPath, 

PSZ pszSEction, 

PCHAR ozFindString 

) 
i 

10 FILE *pfFilo -NULL; /* file ptr for fil e */ 

/* env var */ 

CHAR s zCurLine[NG_BUF_IN_LEN + 1]; /* buffer for file r e ads */ 

CHAR szLi ne [N G_BU F_1N_L EN +1]; /♦ used for processing file line */ 

PCHAR pozTomp ~ NULL; 
15 BOOL fSection - FALSE; 

BOOL fS o tting - FALSE; 

ULONG ulLen — =-Ot buf length for env var 

LONG IRC ~ RC OK; /♦ return cod e H 

20 

PCHAR pozFiloNamo-NULL; /♦ ptr original fil e */ 

25 if(pozFileName !~NULL) 

pfFil e - fopen(pozFiloPath,FO_READ_ONLY); 

30 if ( pfFilo !~ NULL) 
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— { 

memoot(ozCurLino,NUL,NG_BUF_lN_LEN + 1); 

while ( (fgeto(ozCurLino,NG_BUF_lN_LEN,pfFile) !~ NULL) ) 

5 f 

if(fSoction !~ TRUE) 

1 

if(azCurlino[0]'— '[') 

[ 

10 szCurline s zCurline + sizeof(CHAR); 

if(stmcmp(szCurline,pszSection, strlen(pszSection))) 

{ 

fSection - TRUE; 

} 

15 ) /* end if azCurline[0] — T */ 

) /* e nd if fS o ction !~ TRUE */ 

else 

{ 

— if(strstr(szCurline, pszSetting) !~NULL) 

20 { 

Sotting ~ TRUE; 

pszTemp ~ strstr( s zCurline, '-'); 

while(strcmp(pszTemp, 6 '); 

{ 

25 pszTemp ~ pszTemp + sizeof(CHAR); 

} 

pszValu e ~ strcpy(psTemp); 

) /*endif*/ 

) /* end else */ 

30 ) /* e nd whil e */ 
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] /* end if pfFilo !~ NULL */ 

) /* pozFileNamo !~ NULL ♦/ 



if (pfFilo 1- NULL) 

5 -f 

fclose(pfFile); 

-)■ 

return( pszValue); 

10 

} /* end of FindValue() */ 

1 .2.8.1 .7.1.1 6.SoarchAndAddStringtoFile 

* NAME: SearchAndAddStringtoFil o 

it 

* DESCRIPTION: Find string in file and update it with the value 
20 4 passed in. If the sting is not found add it at 

& the e nd of the file. 

it 

* ASSUMPTIONS: Tho filo exists 

25 * 

it 

* REVISION HISTORY: 
± 

* — Date Author Description 
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* — 08/08/97 — Doug Hughes Original code 

*K *f* *fc ^ *fe ^ ^* ^* *^ ^ ^* *^ ^ ^ ^ *^ sfc sfs sfc jjs sjc sjc «flc sjc sjc sjj *jc s|c ?|c 3jc sjc sjc s|c ?jc ?[c s|c jjc sfrs sjc sjc sji #jc sjc sjc 3]c ?)c sjc s^c j|c sfrc sjc sjc ^ 

5 /± 

SearchAndAddStringtoFil e () 

A/ 

LONG SoarchAndAddStringtoFilo ( 

PSZ p s zFil e Nam e Path, 

10 PSZ p s zSection, 

PSZ pszS e archString, 

PSZ pszInsertString 

-) 

-f 

15 FILE *pfLogFile -NULL; /* file ptr for file */ 

FILE *pfFiloT o mp ~ NULL; /* fil o ptr for Original file */ 

PCHAR pszTompPath - NULL; /* temp fil e buffer */ 

20 CHAR — ozTempPath[MAXPATH +1]; /* ptr to temp fil e H 

/* env var */ 

CHAR ozCurLino[NG_BUF_IN_LEN + 1 ] ; — /* buffer for filo roado H 

CHAR ozTempLine[NG_BUF_IN_LEN +1]; — /* uoed for processing fil e 

lin e */ 

25 

PCHAR pozTomp-NULL; /* used for fil e writ e s H 

PCHAR pszTempStart ~ NULL; /* points to start of temp buff e r*/ 

INT — iStartlnd e x ~ 0; /* starting point on lin e wh e r e */ 

/* replac e m e nt valu e should be */ 

30 /* placed H 
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ULONG ulLon — =^ /* buf length for env var */ 

LONG IRC - RCOK; /* return code */ 

BOOL fFoundString - FALSE; 
INT — iLocallnstance ~ 1: 



BOOL fScction - FALSE; 
BOOL fSctting - FALSE; 



* Build full paths for both the original * 

* file and th e n e w fil e *■ 

15 if(pszFileNamePath !~NULL) 
-r 

remo v e (LOG_T EMP_N AM E) ; 

rename(pozFil e Nam e Path, LOG_TEMP_NAME); 

20 

pfLogFile ~ fopon(pozFileNamePath, FOWRITE); 

pfFileTemp ~ fopon(LOG_TEMP_NAM E, FOREADONLY); 

if( pfLogFil e !- NULL) 

t 

25 

* Now both files ar e op e n do th e r e ad and writ e * 

30 momoot(ozCurLino,NUL,NG_BUF_lN_LE N + 1); 
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momo e t(ozTompLino,NUL,NG_BUF_IN_LEN + 1); 
pszT e mpStart ~ s zT e mpLin e ; 

whilo ( (fgets(szCurLin e ,NG_BUF_IN_LEN,pfFileT e mp) !~ NULL) ) 

4 



memcpy(szTempLine, szCurLine, NG_BUF_IN_LEN + 1); 
if(fSoction !~ TRUE) 



4 



10 if (ozCurline[0] — '[') 

{ 

pszTemp szCurlin e + sizeof(CH AR); 

if( s tmcmp(pszTemp,pszSection ? strlen(pszSection))) 

{ 



15 fScction - TRUE; 

r 

) /* endifszCurline[0] — '[' */ 

/* writ e th e lin e s to the new fil e */ 

fprintf(pfLogFil e , pszCurLin e ); 

20 ) /* o nd if fSoction !~ TRUE */ 

else 



4 

if(fSotting l-TRUE) 
— f 



25 if(strstr(szCurlin e , pszSetting) !~ NULL) 

f 



found the s e tting und e r th e section 

writ e th e new valu e to th e file 

30 n 



[l l OU 8 26SM6 8 Q59_1.DOC] 



122 



fSetting - TRUE; 



pszT e mp - strstr(szCurlin e , 



pszTemp ~ pszTemp + sizeof(CHAR); 
*pszT e mp ~ NULL; 



strcat(pszTemp,' '); 



pszT e mp ~ pszTemp + sizeof(CHAR); 
sprintf(pszTemp ? M %s%s %s \n",pszSearchString, 



' ~ \ pszInsertString); 



fprintf(pfLogFile, pszTemp); 



10 fFoundString-TRUE; 

) /*endif*/ 

) /* e nd if ^Setting !~ TRUE */ 

else 



-f 



15 /* 

string und e r th e s e ction alr e ady found 

so copy th e rest of th e fil e to th e new fil e 

n 



fprintf(pfLogFile, pszCurLine); 



20 } 

) /* e nd else */ 



) /* e nd whil e */ 

25 ) /* ondifpfFilo !~NULL*/ 

) /* p s zFileNam e !~ NULL ♦/ 



30 ) /* end if*/ 
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else 

— { 

CHAR ozErrorOut[MAX_ERROR_OUT_LEN + 1];/* for error output 

strings*/ 

5 

IRC ~ RCFA IL OPEN ; 

sprintf(szErrorOut,"%s\nError opening log file.n%s", 

ERRO R_H E A D IN G_3 00D, 

CONTACTINTERS U PPORT) ; 

10 

printf("\n\n%s\n\n",szErrorOut); 

fflush(stdout); 

return IRC; 

15 ) /* end els e */ 

) /*end if*/ 

20 if (fFoundString — FALSE) 
-f 

IRC- 1 

25 if(pfLogFil o 1-NULL) 
-f 

fclose(pfLogFile ); 

-4 

30 if(pfFiloTomp 1-NULL) 
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-f 

fclose(pfFil e Temp); 



5 return(lRC); 

) /* end of S e archAndAddStringtoFileO */ 
1 .2.8.1 .7. 1 . 1 7.EnabloTcpipInConfigSyo 

NAME: EnableTcpiplnConfigSys 

AUTHOR: David Kaatz 

15 

DESCRIPTION: Look in the backup v e rsion of config.sys (config.bac), 
which was created by creat ng, for MPTSTART. If MPTSTART 
was found in config.bac, update config.sys with MPTSTART 
command. — If no MPTSTART line is found, not an error, just return 
20 RC_OK. 

ASSUMPTIONS: config.bac e xist s . 

REVISIONS: 
25 DATE — NAME — DESCRIPTION 



07/09/96 D. KAATZ INITIAL REVISION 
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**/ 

LONG EnableTcpipInConfigSys(VOID) 

i 

5 CHAR szN e wConfSysFile[MAXPATH + 1]; 
CHAR ozBkConfSygFilo[MAXPATH +1]; 
CHAR ozConfSyoFile[MAXPATH + 1]; 
CHAR ozCurLinc[MAX_CONF[G_LINE_LEN + 1]; 
CHAR ozEirorOut[MAX_CONFIG_LINE_LEN + 1]; 
10 PCHAR pszTemp; 

FILE *pfConfig -NULL; 
FILE *pfConTarg - NULL; 

LONG lRc ~ RC OK; 

BOOL fLinoFound - FALSE; 

15 

momoot(ozNowContSyoFilo, NUL, MAXPATH + 1); 
memo6t(ozBlcConfSyoFil6, NUL, MAXPATH + 1); 
memset(szConfiSysFil o , NUL, MAXPATH + 1 ); 
memset(szCurLine, NUL, M AX CONFIG LIN E LEN + 1); 

20 

sprintf(szConfSyoFile, "%a%s", KNOWN N G CONFIG S YS P ATH , 
D EF AULT_CON F IGS Y SFI LE) ; 

oprintf(DzBkConfSyoFilo, "%o%o", KNOWN_NG_CONFIG_SYS_PATH, 
25 BACK_C0NFIG_SYS_F1LE); 

sprintf(szNowConfSysFilo, "%g% s ", KNOWN_NG_CONFIG_SYS_PATH, 
TEMP_CO>JFIG_SYS_FILE); 
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// Open th e backup config file 
//************************** 

pfConfig ~ fopen(szBlcConfSysFilo, FOR E A D_ON L Y) ; 

// Road it until w e find th o "MPTSTART" lino. 
// Watch out for r e marks lines, 

whilc( (fgeto(ozCurLine, MAXCONFIGLINELEN, pfConfig) !~ NULL) 

10 && 

ifLineFound ) 

-f 

if( (pszTcmp ~ strstr(szCurLine, MPTSTART)) !~ NULL && 

strncmp(szCurLin e , "rem", 3) && strncmp(szCurLin e , "REM", 3) ) 

15 { 

fLineFound ~ TRUE; 

fclose(pfConfig); 
20 pfConfig ~ NULL; 
if( IfLineFound ) 

-i 

return RC OK; 

-4 

25 

fLin e Found ~ FALSE; 

// Op e n the config.sys fil e 
2Q jj ********************************************** 
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pfConfig - fopon(ozConfSysFil e , FOAPPEND); 



if(pfConfig !~ MULL) 
5 -f 

// Copy the n e w command into the config.sys 

10 

fput G (MPT_START_COMMAND ? pfConfig); 

fputs("\n\n",pfConfig); 

fclose(pfConfig); 

) // end if 
15 else 

-4 

lRc- 1; 

sprintf(GzErrorOut,''% s \n%G\nyos\nyoS , ',ERROR_HEADING_300_D, 

OPEN ERR, 

20 szConfSysFil e , 

CONTACT INTER SUPPORT); 

printfOn\n%o\nW\ o zErrorOut); 

ffluoh(otdout); 

25 

r e turn lRc; 
) /* e nd of Enabl e TcpipInConfigSys */ 
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1 .2.8.1 .7.1. 1 S.HostNamoRestore 



5 NAME: HostNameR e store 

AUTHOR: David Kaatz 

DESCRIPTION: Look in the backup version of config.sys (config.bac), 

10 which was cr e ated by creat_ng, for th e HOSTNAME" line. 

it to a new version of config.sys, replacing the default 

HOSTNAME" lino that is there. If no HOSTNAME line is 

found, not an e rror, just r e turn RC_OK. 

15 ASSUMPTIONS: config.bac exists. 

REVISIONS: 

DATE — NAME — DESCRIPTION 



20 07/09/96 D.KAATZ INITIAL REVISION 

LONG HostNameRestore(void) 

4 

25 CHAR ozNowConfSyoFilo[MAXPATH + 1]; 

CHAR BzBkConfSyoFil e [MAXPATH + 1]; 

CHAR szConfSyoFilo[MAXPATH + 1]; 

CHAR ozCurLinc[MAX_CONFIG_LlNE_LEN + 1]; 

CHAR ozH o otN am e [ M AX CON F IG LIN E LEN + 1]; 
30 PCHAR pozTcmp; 
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FILE ♦pfConfig -NULL; 
FILE *pfConTarg - NULL; 

LONG lRc RC_OK; 

BOOL fLinoFound ~ FALSE; 

5 

momoot(ozNowConfSyoFile,NUL, MAXPATH + 1); 
memset(szBlcConfSyoFile, NUL, MAXPATH + 1); 
momoot(ozConfSysFile, NUL, MAXPATH + 1); 
momsot(ozCurLino, NUL, MAX_C0NF1G_LINE_LEN + 1); 
10 m o msct(ozHostName, NUL, MAXCON FIGL1NELEN + 1); 

sprintf(szConfSysFilo, "%s%s", KNOWN NG CONFIG SYS PATH, 
DEFAULTCONFIGSYSFILE); 

15 sprintf(szBkConfSysFile, "%s%s", KNOWN NG CONFIG SYS PATH, 
B AC KCON FIGS YSFIL E) ; 

G printf(szN o wConfSysFilo, "%s% s ", KNOWN_NG_CONFIG_SYS_PATH, 
TEMPCONFIGSYSFILE); 

20 

// Open th e backup config fil e 

pfConfig - fopon(szBkConfSyoFil o , FO R E AD ON LY) ; 

25 

// Read it until we find the HOSTNAME- lino. 
// Watch out for r e marks lin e s. 

30 whilo( (fgoto(szCurLine, M AX CON F IG LIN E LEN , pfConfig) !~ NULL) 
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&& 

! fLin e Found ) 

-f 

if( (pozT e mp ~ otrstr(ozCurLino, NG_TCP_HOST_NAME)) !~ NULL && 

5 strncmp(szCurLin e , "rem", 3) && Gtrnomp(szCurLine, "REM", 3) ) 

r 

fLineFound ~~ TRUE; 

s trcpy( s zHostName, szCurLin e ); 

— * 

io -4 

fclose(pfConfig); 
pfConfig-NULL; 
— if( ! fLineFound ) 

15 return RC OK; 

-4 



fLineFound FALSE; 



// Open the config.sys file 

pfConfig- fopen(ozConfSysFile, FORE A D_ON L Y) ; 
// Op e n th e temporary file 

pfConTorg- fopen(szNewConfSyoFil o , FO WRITE); 
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// Copy the config.sys into the temporary file 

// until the HOSTNAME- line is reached, then 

// ins e rt th e previou s ly found hostname, then 

// copy th e r e st of the fil e into the temp fil e . 
5 // ********************************************** 

// Read and copy except for the HOSTNAME- line. 
// Watch out for remarks lin e s. 

10 pszTemp - fgets(szCurLino, M AX CON F IG LIN E LEN , pfConfig); 
while( pszTemp !~ NULL ) 

-f 

if( strstr(szCurLine, NG TCP H O ST N A M E) !~ NULL && 

strncmp(szCurLin o , "REM", 3) && 

15 strncmp(szCurLin e , "rem", 3) ) 

{ 

fputs(szHostName, pfConTarg); 

etee 

20 { 

fputs(szCurLin e , pfConTarg); 

— f 

pszTemp - fg e to(ozCurLin e , MAX_C0NFIG_L1NE_LEN, pfConfig); 

25 fclose(pfConfig); 

fclos e (pfConTarg); 

30 // D e let e config.sys, and rename th e temp file 
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// to config.sys. 

// ^»»»»^c» *************************************** 

remove(szConfSy s Fil e ); 

lRc ~ (LONG) renam e (szNewConfSysFil e , szConfSysFil e ); 

return lRc; 
) /* end of HostNameRestore */ 



1.2.8.1.7.1.1 9.SystemBackup 

10 

NAME: SystemBackup 

15 AUTHOR: David Kaatz 

DESCRIPTION: Backup predefined list of files to d:\upgrad e \backup. 

No error if file does not exi s t. 

Error if d:\upgrade\backup is not writable. 

20 

ASSUMPTIONS: Wo always backup to d:\upgrado\backup. 

No blank lines in th e backup. 1st file (sourc e file 

of names to backup). 

25 REVISIONS: 

DATE — NAME — DESCRIPTION 



09/11/95 D. KAATZ INITIAL REVISION 

11/16/95 DK Put system backup volum e label on disk e tt e . 
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04/19/96 DK Display an "in progress" m e ssag e whil e accessing 

th e diskette. Take predefined list of files from 

t e xt fil e on th e hard driv e inst e ad of hard coding it. 

5 1 1/02/97 — BH Change proc e dure to backup to th e passed in driv e 

**** * / 

PL 

10 LONG Syot e mBacleup(PSZ pszPath) 
H 

LONG SystomBackup 
( 

— veid 
15 ) 
i 

/* STATIC VARIABLES */ 
/* NONE */ 

20 /* AUTOMATIC VARIABLES */ 
LONG lRo-RC_OK; 
BOOL bBroalcLoop - FALSE; 

CHAR ozTarg e tPathFil e [ MAXPATH ] - " d:\upgrado\backup:"; 

CHAR ozDrf'l]; /* drive */ 

25 CHAR azPath[MAXPATH] ; — /* path */ 

CHAR szName[16]; /* nam e */ 

CHAR szExt[ 5 ]; /* ext e nsion */ 

ULONG ulOpCodo ~ 0L; // | DCP Y FAILE AS ; /* Copy op code */ 
INT iTrgtL e n - otrlon(ozTargetPathFil e ); 
30 ULONG ulL e ngth; 
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API RET apiRct; 

PEAOP2 EABuf; /* extended attribute buffer */ 

VOLUMELABE L VolLabel; /* diskette volume label */ 

SPAF1LE opaLiotFil e ; 

5 

/* FUNCTION BODY */ 

/* initialize variables */ 
m e mset( szDr, — 0, siz e of(szDr) ); 
10 memset( szPath, 0, sizeof(szPath) ); 

mems e t( szNam e , 0, s izeof(szName) ); 
m e mset( szExt, 0, sizeof(szExt) ); 

//CLEARSCREEN; 

15 

//GetEnvPath( NG STAG E_D1R_EN V_V A R, spaListFilo.sNamo ); 

otrcpy( spaLiotFil e .oNam e , UPGDBKUP_F[LE_LIST ); 
opaLiotFile.chMode — - READ ACCESS; 
20 spaListFile.usFil e Typ e ~ FT_TEXT; 

lRc ~ FileOp e n( &spaListFile ); 

if( IRc !~ RC_OK ) 
25 -{ 

printf( EOL CHARS ); 

printf( STR L1STFILE ERR ); 

return IRc; 

— r 

30 
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EABuf-O; 



/* no extended attribute s ar e d e fined */ 



/* disabl e popup error msgs, if no disk is in A */ 
DosError( F E R R_D I S A B L E H A R D E R R ); 

5 

/* Post me ss age that says job is in progress */ 

pri nt f ( STR_B AC K U P_IN_P RO G R E S S ) ; 
fflush(stdout); 

10 

p& ± 

— * Loop over all system files, attempting 
— * to copy them to d:\upgrad e \baclcup. Ignore any 
— * missing system file, 
15 — * n 

IRc Fil e Read( &spaListFil e , pszSystemFiles, &ulLength, MAXPATH ); 

\vhile( bBreakLoop — FALSE && IRc — RCJ3K && *pszSystomFiles ) 
20 — { 

Fil e SplitPath( pszSystemFiles, s zDr, szPath, szName, szExt ); 

strcat( szTargetPathFil e , szPath ); 

/* Cr e ate targ e t directory */ 

25 if( szName[0] — 0 ) 

{ 

/* r e mov e trailing 'V charact e r */ 

szTarg e tPathFilo[otrlon(ozTarg e tPathFilo) 1] - 0; 

30 apiRot ~ DooCroatoDir( s zTarg e tPathFil e , EABuf ); 
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if( apiRet !~ RC OK ) 

r 

printf(EOL_CHARS); 

printf(STR_DIR_CREATE ERR, apiRet); 

5 DosError( FERRENABLEHARDERR ); 

FileClose( &spaListFi1e ); 

return RC_SYS; 

f 

10 

szTargetPathFil e [iTrgtLen] ~ 0; 

— )■ 
else 

r 

15 strcat( szTargetPathFile, szName ); 

strcat( szTargetPathFile, szExt ); 

apiRet DosCopy(pszSystemFiles, szTargetPathFile, ulOpCode); 

s witch (apiRet) 

20 j- 

case RCJ3K: 

cas e ERROR FI LE_N OT FOUN D : 

ca s e ERROR_PATH_NOT FOUND: 

/* res e t target path */ 

25 szTarg e tPathFile[iTrgtLen] - 0; 

break; 

d e fault: 

case ERROR DISK FULL: 

30 cas e E RROR E A S_N OT_S U P P O RT ED : 
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caoo ERROR_NEED_EAS_FOUND: 

printf(EOL_CHARS); 

pri ntf( STRB ACKUPF A I L, apiRct); 

printf(EOL_CHARS); 

5 printf(CONTACT_INTER_SUPPORT); 

IRe ~ RCSYS; 

bBroakLoop - TRUE; 

br e ak; 

10 cas e E RROR_D R [ VE LOC KE D : 

printf(EOL_CHARS); 

printf( STRDRIVELOCKED ); 

IRe - RCSYS; 

bBr e akLoop - TRUE; 

15 break; 

f 

} 

20 if( IRe ~- RC_OK ) 

r 

IRe - FilcRead( &opaLiotFile, pozSystemFiles, &ulL e ngth, MAXPATH ); 

— } 

if( strncmp(pszSyst e mFil e s, ENDOFFILE, strl e n(ENDOFFILE)) — 0 ) 

25 { 

bBr o akLoop - TRUE; 

} 

— r 

30 DooError( FERR ENABLEHARDERR ); 
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FileClose( &spaListFile ); 
printf( EOL CHARS ); 
printf( STR WARN_ONE ); 
printf( EOLCHARS ); 
printf( STRJWARNTWO ); 
fflush( s tdout); 
r e turn lRc; 
) /* LONG SystemBackupO */ 

1. 2.8.1.7.1. 20.SystemRestore 

**** 

FUNCTION: Syst o mRe s tor e 

DESCRIPTION: Restor e syst e m fil e s from passed in driv e . 

Use the same list, pszSy s temFiles, that was used 

to backup the system files. Just chang e the 

s ource drive to the passed in drive:". Ignore any files that 

don't e xist on the floppy. 

ASSUMPTIONS: 

Do not need to create target dir e ctories on target drive. 

No blank lines in th e backup.lst fil e (sourc e fil e 

of names to backup). 

First file named in backup.lst MUST NOT BE config. s ys 

or its variations. 
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REVISIONS: 

DATE — NAME — DESCRIPTION 



05/15/96 D.KAATZ INITIAL REVISION borrowed from ngbackup.c 

5 07/10/96 D.Koatz 

1 1/02/97 — DH Chang e proc e dur e to backup to pass e d in driv e instead 
ef-etr 

***/ 

10 LONG Syst e mR e stor e ( PSZ pszPath ) 
i 

/* STATIC VARIABLES ♦/ 

/* AUTOMATIC VARIABLES */ 
15 LONG — lRc ~ RC OK; 

CHAR — szSourcePathFilo[MAXPATH]; 

ULONG ulOpCode - 0L | DCPY FAILEAS | DCPY_EX1STING; /* Copy op cod e */ 
UCHAR FSInfoBufllO]; /* Fil o sy s t e m info buffer */ 
SPAFILE spaListFile; 
20 ULONG ulLongth; 

BOOL — bVersionO ~ FALSE;// restoring from a version 0 backup diskett e ? 

/♦ FUNCTION BODY */ 

25 /* disabl e popup error msgs, if no disk is in A */ 
DosError( FERR DISABLEHARDERR ); 

— Open the mast e r list of 
30 — syst e m files file. 
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//GetEnvPath( NG_STAGE_DIR_ENV_VAR, spaLiotFilo.oNamo ); 

otropy( opaListFile.oName, UPGDBKUP_FILE_LIST ); 
5 opaListFilo.chModo — - READ_ACCESS; 
spaListFile.usFileTyp e ~ FT_TEXT; 

IRc ~ FileOpen( &spaListFil e ); 
if( IRc !~ RC_OK ) 
10 -4 

printf( EOLCHARS ); 

printf( STR_LISTFILE_ERR ); 

printf( EOL CHARS ); 

printf( CONTACT_INTER_SUPPORT ); 

15 r e turn IRc; 

— r 

printf( EOL CHARS ); 
printf(STR_RESTORE_IN_PROGRESS); 
20 fflush(stdout); 

IRo ~ FiloRoad( &spaLiotFilo, pozSyotemFiles, &ulLength, MAXPATH ); 

whilo( IRo — RC_OK && fpozSyotemFiles ) 
25 -f 

— m 

* The dir e ctory only portions of th e list 

* will not b e a probl e m for us, as DosCopy 

* will return ERROR PATH NOT FOUND, which 

30 * w e ignor e . 
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strcpy( szSourcePathFil e , pszSystemFiles ); 
szSourc e PathFiI e [0] ~ 'd:\upgrad e \backup'; 



5 lRc - DosCopy( szSourcePathFil e , pszSy s t e mFil e s, ulOpCod e ); 

switch (lRc) 

— t 

caoo RC_OK: 

caoe ERROR_FILE_NOT_FOUND: 

10 caoo ERROR_PATH_NOT_FOUND: 

IRo ~ RC_OK; 

br e ak; 

d e fault: 

15 cao e ERROR DISK FULL: 

caoo ERROREASNOTSUPPORTED: 

caoe ERROR_NEED_EAS_FOUND: 

printf( EOLCHARS ); 

printf( STR_RESTORE_FAIL, lRc ); 

20 printf( EOL CHARS ); 

printf( C0NTACT_1NTER_SUPP0RT ); 

DooError( FERR ENABLEHARDERR ); 

FileClose( &apaLiotFil e ); 

25 return RC_SYS; 

caoo ERROR DRWE LOCKED: 

printf( EOL CHARS ); 

printf( STR DRIVE LOCKED ); 

30 printf( EOL CHARS ); 
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printf( CONTACT JNTERSUPPORT ); 

DosError( FERR ENABLEHARDERR ); 

FileClose( &spaLi s tFil e ); 

5 r o tum RC SYS; 

IRc ~ FileRead( &spaLisfFile, pszSystemFiles, &ulLength, MAX PATH ); 

U 

10 // Ch e ck if r e ached e nd of file. G e tting an EOF return 

// cod e would be ok, but we can't t e ll normal EOF from 

// a prematur e EOF, so an e xp e ct e d endoffile t e xt in 

// th e fil e s ee ms mor e sur e . 

// 

15 if( strnemp(pozSystemFil e s, ENDOFFILE, otrl e n(ENDOFFlLE)) — 0 ) 

{ 

*p s zSystemFiles ~ 0; // set to empty s tring to break from whil e loop 

— } 

20 U 

// If restoring from a v e rsion 0 diskett e : 

U — Don't restore config.sys files. 

U . 

25 U- 

// Check for config.sys fil e versions 

// Assumption is that they will be listed 

// contiguously in th e backup.lst file. 

U 

30 if( strstr(strlwr(pszSystemFiles), DEFAULT CONFIG SYS FILE) ) 
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— r 

// If config fil e , copy to config.bac. 

strcpy( szSourcePathFile, pszSyst e mFiles ); 

s zSourcePathFil e [0] ~ 'd:\upgrade\backup'; 

5 

sprintf( pszSystemFiles, "%s%s", 

KNOWN_NG_CONFIG_SYS_PATH, 

BACK_CONFIG_SYS_FILE); 

IRo ~ DosCopy( szSourcePathFile, pszSyst e mFil e s, ulOpCod e ); 

10 lRc ~ Fil e R e ad( &spaListFil e , pszSystemFiles, 

&ulLength, MAXPATH ); 

) /* ond while lRc — RC OK && *pszSystomFilos */ 

15 

Fil e Close( &spaListFile ); 

Do s Error( FERR ENABLEHARDERR ); 
if( lRc — RC_OK ) 
20 —{ 


** R e nam e th e sys config r e port fil e so it app e ars again. 

— n 

CopyEnvFi 1 o ( DC MEN V_M AIM, SAVED_NG_INI_ASCII_FILE, 

25 DCM EN V_M A IN , DEFAULT_NG_I>J1_ASCII_FILE); 

DolEnvFile (DCMENV MAIN, SAVED_NG INI ASCH FILE); 

H- 

return lRc; 
30 ) /* end of systemrestor e */ 
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1 .2.8.1.7. 1 .21 .CreateUpgradeTmpFil e 



FUNCTION: Creat e Upgrad e TmpFile 

5 AUTHOR: D.Kaatz 

DESCRIPTION: — R e ad th e last successful s e ction from the ng_oonfg.log 

file, use that to writ e the tmp fil e that will 

b e us e d by cr e at_ng to update th e system. Kind of a 

kludgy way to achi e v e a syst e m updat e , but this allows 

10 a large amount of functional lev e raging from th e 

cr e at_ng e xecutable- 



Revision History: 

DATE COMMENT 

15 

05/22/96 Copi e d larg e ly from Wad e H's code in fieldng.c. 

20 CreateUpgradeTmpFile(PSZ pszPath) 
H 

LONG Cr e at e Upgrad e TmpFile 
( 

void 

25 ) 
4 

CHAR szErrorOut[MAX_ERROR_OUT_LEN + 1]; /* for orror output strings */ 
CHAR szConfigTag[NG_BUF_IN_LEN + 1]; — /* config tag or luggag e tag */ 

CHAR szOrgConfigTag[NG_BUF_IN_LEN +1]; /* original config tag or */ 

30 /* luggag e tag H 



[ 1 1011 8 265/16 8 959,1. DOC] 



145 



CHAR ozCurLino[NG_BUFJN_LEN + 1]; /* buffer for reading from fil e */ 

PCHAR p s zCurEntry ~ NULL; /* ptr us e d to e xtract value — */ 

/* curr e nt line */ 

USHORT usStrLoc ~ 0; /* us e d to mov e in current lin e */ 

5 /* buff e r H 

CHAR szDownLinol [DOWN_LINE_VAL_LEN + 1]; /* downlin e #1 valu e H 

CHAR szDownLino2[DOWN_LINE_VAL_LEN + !];/♦ downline #2 valuo H 

CHAR szTUpLino[UP_LINE_VAL_LEN + 1]; — /* Tomp uplino valuo H 

CHAR ozTDownLinol[DOWN_L1NE_VAL_LEN + 1]; /* Temp downlin e #1 valu e 

10 H 

CHAR ozTDownLino2[DOWN_LINE_VAL_LEN + 1]; /* Tomp downlino #2 valuo 
CHAR szUpLine[UP_LINE_VAL_LEN + 1]; — /* upline value */ 



15 PCHAR pszTemp - NULL; /* us e d for string fxns H 

CHAR szNGCfgLogFullPath[MAXPATH + 1]; /♦ compl e t e path for th e H 

/* n e xtg e n config log fil e */ 

BOOL f>JGCfgLogFileFound - FALSE; /♦ set if NG cfg log file exists */ 

CHAR szNGTempCfgPath[MAXPATH + 1]; /♦ complete path for the H 

20 /* nextgen t e mp config fil e H 

BOOL fHiddonFile ~ FALSE; /* s e t if hidden fil e */ 

LONG lFil e RC ~ RC_OK; /* usod in call to FileExist — */ 

FILE* pfCfgLog ~ NULL; /* fil e ptr for NG config log */ 

FILE* pfT e mpCfg - NULL; /* file ptr for t e mp NG config */ 

25 BOOL fExit ~ FALSE; /* set to tru e if e rror requires */ 

. /* program t e rmination */ 

BOOL fS e rialCrd - FALSE; /* FLAGS */ 

BOOL fAddEth e r - FALSE; /* FLAGS H 

BOOL fUpFound FALSE; /* FLAGS */ 

30 BOOL fDownl Found -FALSE; /* FLAGS */ 
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BOOL fDown2Found -FALSE; /* FLAGS H 

BOOL fPortl Found -FALSE; /* FLAGS */ 

BOOL fPort2Found -FALSE; /* FLAGS */ 

BOOL fSerialFound - FALSE; /* FLAGS V 

5 BOOL fOrgCfgTagFound - FALSE; /* FLAGS H 



/* matches DCS 300 version — H 

m e ms e t(szConfigTag, NUL, NGBUFINLEN + 1); 

memset(ozOrgConfigTag, — NUL, NG BUF IN LEN + 1); 
10 memset(szNGCfgLogFullPath, NUL, MAXPATH + 1); 

memsat(szNGTompCfgPath, NUL, MAXPATH + 1 ); 

momoot(BzDownLinel, NUL, DOWN LIN E_V AL LEN + 1); 

momoet(ozDownLin e 2, NUL, DOWN_LINE_VAL_LEN + 1); 

momoet(ozUpLine, — NUL, U P_LIN E_V A L_LEN + 1); 
15 memoet(ozTDownLin e 1, NUL, DO WN_L1N E_V AL_LEN + 1); 

momoot(azTDownLino2, NUL, DOWN_LINE_VAL_LEN + 1); 

m o mo o t(ozTUpLino, N U L, UP_LIN E_V A L_LEN +1); 

20 * Opon of the NextGen * 

* DCS 300 config log file. * 

pszTemp ~ szNGCfgLogFullPath; 

G printf( s zNGCfgLogFullPath,"%s",KNOWN_NG_SYSINI_PATH); 
25 if(GzNGCfgLogFullPath[otrlon(pszTemp) 1] !~ OSCHAR DIR) 

GzNGCfgLogFullPath[otrlen(pozTemp)] - OSCHAR DIR; 

Gtrcat(szNGCfgLogFullPath,DEFAULT_NG_CONFIG_LOG_FILE); 
pozTemp ~ NULL; 

30 lFiloRC - FiloExioto(ozNGCfgLogFullPath, &f>JGCfgLogFiloFound, 
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&fHiddonFile); 



if ( (lFiloRC " RC_OK) && (fNGCfgLogFiloFound — TRUE) ) 
* Fil e exists; open it for read mod e * 

pfCfgLog - fopen(szNGCfgLogFullPath,FO_READ_ONLY); 

10 -4 

else 

-f 

* Fil e does not exist; this is an — * 

15 * e rror; Must contact Intermeo *• 

* s upport *• 

sprintf(gzErrorOut,"%o\n%o\n%o\n' , > ERROR_HEADING_300_D > 

NO_CONFIG_LOG_FILE_FOUND > 

20 CONTACT INTER SUPPORT); 

printf("\n\n%s\n",szErrorOut); 

fflush(stdout); 

25 * Set to e xit * 

return RC_EX1T; 

— r 

30 



[ 1 1011 8 265/'16 8 059_l.POC] 



148 



if (pfCfgLog !~ NULL) 

-4 

* Now read in NG config log fil e to * 

5 * det e rmine what is curr e ntly in th e * 

* system with respect to upline and * 

* downline cards as well as serial — * 

* and RF cards, * 

* This info should only be written — *■ 

10 * to the NG config log file if a — * 

* configuration has been completed — *■ 

* successfully, however car e should * 

* be taken to get the results from * 

* the LAST SUCCESSFUL configuration. * 

15 * Get the la s t entries * 

* since this file is appended to as * 

* a DCS 300's config is changed, * 

mcm G ot(szCurLine > NUL,NG_BUF_IN_LEN + 1); 

20 

while (fgets(szCurLine ? NG_BUF_IN_LEN ? pfCfgLog) !~ NULL) 

{ 

* Strip out all whit e spac e from * 

25 * current lin e *■ 

StripCRNL(szCurLin e ); 

usStrLoc ~ (USHORT) strspn(szCurLine,szWhit e s); 

pszCurEntry ~ szCurLine; 

30 pszCurEntry ~ pszCurEntry + (int) usStrLoc; 
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* R e mov e any succ e ssive spaces — *• 

RemSucc e ssiv e D e lims(pszCurEntry,SP); 

if ( stmcmp(StrToUpr(pszCurEntry), 

StrToUpr(NG_CONFIG_TAG_EQU_STR), 

strlen(NG_CONFlG_TAG_EQU_STR)) — 0 ) 

i 

— // Check that the following 

— // configuration data is for 

— // th e same version as this 

— // fi e ld upgrade 

— // Do this by looking at the 

— // configuration (luggag e ) tag. 

— // For upgrades, we don't expect th e 

— // configuration data to be the sam e 

— // version as we want to upgrade to. 

— pszCurEntry ~ pszCurEntry + 

strl en(N GCOM F IGT AG_EQU_STR) ; 

usStrLoc ~ (USHORT) strspn(pszCurEntry,szWhites); 
— pszCurEntry ~ pszCurEntry + (int) usStrLoc; 

II :jt jj/L % $t % % :jc ifc % sjc ifr :fr % if: 

// Valid luggag e tag? * 

if ( strncmp(pszCurEntry, MODEL_300J,UG_PREFL\, 
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-4 

// ♦ Now g e t th e original config tag * 

strncpy( szOrgConfigTag, 

pszCurEntry, 

atrlon(NG_CONFIG_TAG_EQU_STR)); 

fOrgCfgTagFound - TRUE; 

-4 

if ( strncmp(StrToUpr(pszCurEntry),NG_CONFIG_UPLINE_STR, 
s trl e n(NG_CON FIGU PLINESTR)) — 0 ) 

■4 

pszCurEntry - pszCurEntry + strlcn(NG_CONFIG_UPLINE_STR); 
— usStrLoc ~ (U SHORT) strspn(pszCurEntry,szSkips); 
— pszCurEntry ~ pszCurEntry + (int) usStrLoc; 

strncpy(szTUpLine, pazCurEntry, UP_LINE_VAL_LEN); 

if ( (strcmp( s zTUpLi ne, ETH ER UP) — 0) | | 

(Btromp(azTUpLine,TOKEN_UP) — 0) | ] 

(stremp(szTUpUno,TWINAX_UP) — 0) | | 

(strcmp(szTUpLine,COAX_UP) — 0) [ | 

(otrcmp(szTUpLino,SDLC_UP) — 0) ) 

-4 

fUpFound -TRUE; 

-4 

— else 



[1 1041 8 265A16 8 959J.DOC] 



} 

5 

} 

else if( strnomp(StrToUpr(pozCurEntry),NG_CONFIG_DOWN1_STR, 

otrl o n(NG_CONFIG_DOWNl_STR)) — 0 ) 

t 

10 pszCurEntry - pszCurEntry + otrl o n(NG_CONFIG_DOWN 1 _STR); 

usStrLoo ~ (USHORT) strspn(pszCurEntry,szSkips); 

pszCurEntry ~ pszCurEntry + (int) usStrLoc; 

15 strncpy(ozTDownLinel,pszCurEntr>',DOWN_LlNE_VAL_LEN); 

fDownl Found ~ TRUE; 

Y 

20 e ls e if ( strncmp(StrToUpr(pszCurEntry),NG_CONFlG_DOWN2_STR, 

otrl o n(NG_CONFlG_DOWN2_STR)) — 0 ) 

{ 

pszCurEntry - pozCurEntry + Gtrlen(NG_CONFIG_DO\¥N2_STR); 

25 usStrLoo ~ (USHORT) otropn(pszCurEntry,ozSkips); 

pszCurEntry ~ pszCurEntry + (int) usStrLoc; 

strnopy(szTDownLin e 2 > pozCurEntr>^DOW^^_L[^^E_VAL_LE^O; 

fDown2Found -TRUE; 

30 
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e ls e if ( strncmp(StrToUpr(pszCurEntry), 

NGCONFIGDOAVN 1 PORTSTR, 

strl ( m(NG_CONFlG_DOWNl_PORT_STR)) — 0 ) 

4 

— pszCurEntry ~ pszCurEntry + 

Gtrl e n(NG_CONFlG_DOWN 1 _PORT_STR); 

— usStrLoc ~ (USHORT) strspn(pszCurEntry,szSkips); 
— pszCurEntry ~ pszCurEntry + (int) usStrLoc; 

if ( strcmp(pszCurEntry,TRUE_STR) — 0) 



fPortl Found ~ TRUE; 



else if ( strcmp(pszCurEntry,FALSE_STR) — 0) 



fPortl Found -TRUE; 



■else 



* Error * 



} 

r 

e ls e if ( strnonip(StrToUpr(pG2CurEntr> r ) ? 
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NG_CONFIG DOWN2 PORT STR, 

strl o n(NG_CONF]G_DOWN2_PORT_STR)) — 0 ) 

r 

pszCurEntry ~ pszCurEntry + 

5 otrlon(NG_CONFIG_DOWN2_PORT_STR); 

usStrLoc - (USHORT) strspn(pszCurEntry,szSkips); 

pszCurEntry ~ pszCurEntry + (int) usStrLoc; 

10 if ( strcmp(pszCurEntry,TRUE_STR) — 0) 

f 

fPort2Found -TRUE; 

r 

15 ol s o if ( otrcmp(pszCurEntry,FALSE_STR) — 0) 

c 

fPort2Found -TRUE; 

f 

etee 

20 [ 

♦ Error * 



25 } 

r 

olso if ( strncmp(StrToUpr(pszCurEntr>'),NG_CONFIG_SERIAL_STR, 

strlon(>iG_CONFlG_SERIAL_STR)) — 0 ) 

30 [ 
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5 



25 



pszCurEntry - pszCurEntry + strlen(NG_CONFIG_SERIAL_STR); 

usStrLoc ~ (USHORT) strspn(pszCurEntry,szSkips); 
pszCurEntry ~ pszCurEntry + (int) usStrLoc; 

if ( otrcmp(pozCurEntry,TRUE_STR) — 0) 

4 



* Serial card installed. — *- 

fSorialCrd - TRUE; 

fSerialFound - TRUE; 

y 

ols o if ( s tromp(pazCurEntry,FALSE_STR) — 0) 

15 1 

fSorialCrd - FALSE; 

fSorialFound - TRUE; 



4 



-eke 



20 { 

* Error * 



4 



* This next else checks for a success string in the config — *■ 

30 * log file. A known pot e ntial probl e m could b e if on e of the * 
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* abov e six valu e s was missing in th e currently r e ad config * 

* but had b e en pr e viously r e ad in a chronologically e arli e r * 

* entry in th e ng_confg.log fil e . 

* Th e old value would b e us e d as th e valu e for this config 3 

5 * parameter. This is especially tru e for th e BOOL values 1 

* (fSorialCrd,fPortl Found, fPort2Found). *■ 



else if ( (fUpFound — TRUE) && (fDownl Found — TRUE) && 

10 (fDown2Found — TRUE) && 

(fPortl Found — TRUE) && (fPort2Found — TRUE) && 

(fSorial Found — TRUE) && 

(fOrgCfgTagFound — TRUE) ) 



r 

* Have found values for e very parameter * 

* Now make sur e that next line *■ 

* indicates that this was a successful * 

* config, if not throw the stuff away * 

20 * and keep going * 



if (strncmp(StrToUpr(pszCurEntry) ? 

StrToUpr(NG_CONFIG_SUCCESS_STR), 

25 strlen(NG_CONFIG_SUCCESS_STR)) — 0) 

i 

* Found a succ e ss string. Stor e * 

* values for upline and downlines — * 

30 * and s e t flag for good r e ad *■ 
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stmcpy(ozUpLine,szTUpLino,UP_LINE_VAL_LEN); 

strncpy(szDownLinel ,szTDownLine1 , D O WNLIN E_V A LLEN ) ; 

strncpy(szDovvnLino2,szTDownLin e 2,DOWN_LINE_VAL_LEN); 

5 

} 

else 

[ 



10 } 

* reset for next pass * 

15 fUpFound ~ FALSE; 

fDownl Found — - FALSE; 

fDown2Found — ~ FALSE; 

fPortl Found — - FALSE; 

fPort2Found — - FALSE; 

20 fSerialFound - FALSE; 

fOrgCfgTagFound - FALSE; 

f 

) // ond of whilo (fgoto(ozCurLino,NG_BUF_IN_LEN,pfCfgLog) !~ NULL) 

25 ) // e nd ofifpfCfgLog!- NULL 

* Op e n the temporary fi e ld update file * 
30 if (fExit l-TRUE) 
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-c 

pszTemp ~ szNGTempCfgPath; 

sprintflazNGTempCfgPath, "%o%o%o", EDR1VE, 

OSCHARDIR, UPGRADEDIR); 

5 if(ozNGTempCfgPath[otrlon(pozTomp) 1] !~ OSCHAR DIR) 

ozNGTompCfgPath[otrlen(pozTomp)] - OSCHAR DIR; 

Gtrcat(ozNGTempCfgPath, DEFAULT_NG_TEMP_UPGRAD_FILE); 

pszT e mp ~ NULL; 

10 

pfT o mpCfg ~ fopen(ozNGTompCfgPath, FO_WRITE); 

if (pfT e mpCfg — NULL) 

{ 

* Error can't op e n t e mp cfg fil e * 

* for writing of field update — *■ 

* info *• 

20 oprintf(ozErrorOut,"%o\n 0 / ( ,o\nyeo\ii",ERROR_HEADlNG_300_D > 

NGTEMPUPGRADFILEERR, 

CONTACTINTERSUPPORT); 

printf(''\n\n%s\n'',ozErrorOut); 

fflush(stdout); 

25 

fExit - TRUE; 

fclos e (pfCfgLog); 

roturn RC_EXIT; 

— * 
30 — } 
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if (fExit !-TRUE) 

* Now build th e th e config tag string * 

5 * Note use of "%3.3o" for the output * 

* of the MODE L_3 OO LUG P REFIX * 

if (fExit !-TRUE) 

{ 

10 sprintf(szConfigTag, 

"%S%S%s", 

MODEL_300_LUG_PREF1X,VERSION_STR, 

&azOrgConfigTog[otrl e n(MODEL_300_LUG_PREFlX) + 

strlon(VERSIONSTR)]); 

15 — 1 

* Put info into t e mp config fil e — *• 

* this will b e read in by th e *• 

20 * creat_ng. e xe and used to s e t — * 

* up th e DCS 300 for the new — * 

* field updates * 

fprintf(pfT o mpCfg,"%s\n",szConfigTag); 

25 fprintf(pfTempCfg,"%dW',(int) fSerialCrd); 

fprintf(pfrompCfg,"%dW,(int)fAddEther); 

-4 

fcloGc(pfCfgLog); 
fclose(pfTempCfg); 
30 roturn RC_OK; 
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) /* end of CreateUpgrad e TmpFil e () */ 
1.2.8.1 .7. 1.22 .DosExecPgm Wrapp e r 

5 

*** 

FUNCTION: DosExecPgmWrapp e r 

AUTHOR: D. Kaatz 

10 DESCRIPTION: A gen e ric way to call th e DosExecPgm function. 

Pass in the program to call and a string of command line 

inputs. 

RETURNS: Result of call to DooExocPgm 

15 REVISIONS: 

DATE — NAME — DESCRIPTION 



06/25/96 D.KAATZ INITIAL REVISION 

*************** ************ ********************************************** 

20 

LONG DooExocPgm Wrapp e r(PCHAR szPgm, PCHAR ozArgo) 
•f 

CHAR ozObjoctBuff e r[FILES_GP_NAME_SIZE]; 

RESULTCODES R e sults; 

25 PSZ pszArgList; /* Formatt e d argument list for DosEx e cPgm */ 

— P-SZ pszTemp; /* Temporary argument buffer */ 

LONG IRet 

pszArgList - (PSZ)MomAlloc(FILES_GP_NAME_SIZE + 3); 
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if (pozArgLiot — NULL) 
-t 

IRc ~ RC JV1EM; /* system out of memory */ 

5 printf( "\nSystem out of memory." ); 

return IRc; 

— ) /* end if <pszArglist> ~ null */ 



—(A */ 

10 /* Initialize the argument list for the DosExecPgm */ 

/* ~~> the program name is first, followed by the arguments */ 

/* space separated, and double NUL terminated. H 

/* <pgm name> NUL <arg list> NUL NUL */ 

—/* n 

15 strcpy (pszArgList, ""); 

// Store the process name in the argument list 
p s zTemp - StrInsStr(pszArgList, 0, szPgm); 
// Append a null after th e process name 

pszTemp ~ StrInsChr(pszArgList, (USHORT)strlen(szPgm), NUL, 1); 
20 // Stor e the passed argument string in the location 

// after the process name and NUL 

StrInsStr(pszTemp, 0, szArgs); 

// Set the double NU L's at the end of th e argum e nt list 

StrInsChr(pozTomp, (USHORT)strlen(szPgm), NUL, 2); 
25 IRc ~ (LONG)DosExocPgm( 

szObj e ctBuff e r, 

FILES GP NAME_SIZE, 

EXEC_SYNC, // synchronous ex e cution 

pszArgList, // command lin e input to th e ex e 

30 0y 
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&R es uIts, // results from running pgm 

szPgm); 



MemFre e ( pszArgList ); 
5 r e turn IRc; 

) /* end of DosExecPgmWrapper */ 

1.2.8A7.2,Pseudo code for upgrade. h 

I o ft ft ft 

* FILE NAME: upgrade.h 

* PURPOSE: — This is the include fil e for upgrade.c 

15 4 This file also includes the prototypes and variables 

4 needed by other subsy s tems (e.g., protoypes for VSE subsystem). 

* AUTHOR: — D. Hughes 
20 * DATE: 08/15/97 

* COPYRIGHT (c) 1997 1NTERMEC CORPORATION, ALL RIGHTS RESERVED 

25 

/* 

Th e s e will now b e passed in paths. 

tfd o fin o UPGRADE ? ATH "d:Wupgrade" 

tfd e fine UNZIP EXE "o:\\tools\\UNZIP.EXE" 
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//defin e DJMAGE " qq d:\\upgrade\\d_imago.zip d D:\\" 

//d e fine C IMAGE " qq d:\upgrade\Wc_imag e .zip d C:\\" 

5 //define LOGFILE "d:\\upgrado\\upgrad.log" 

//define PHASE "PHASE-" 

//define TEMP_NAME_PATH "a:\\tompfile.bac" 

////define MAXPATH gO 

//define NG_BUF_IN_LEN 280 

10 

//dofino C_DRIVE '+Gt^ 

//define DDR1VE 

//d e fin e CD_ROM_DRIVE "G:" 

15 #define COPY COMMAND "COPY " 

#defino FDISK.COMMAND "FDISK " 

#d o fino REDIRECT OUTPUT ">" 
#d o fin o REDIRECT INPUT "<" 

20 //d e fin e INPUT_F1LE "inputfil.txt" 

//define NULFILE ±mP 

//define MAXERROROUTLEN 560 

25 //define RC_FAIL_OPEN 1 

//dofino ERROR_HEAD1NG_300_D "Modol DCS 300 " 

//d e fin e CONTACT SU P ER ABQRT "Contact ouporvioor Aborting." 

//define CONTACT_SUPER "Contact supervisor." 

//define CONTACTJNTERSUPPORT "Contact Intermoc Support." 

30 //d e fin e C0PY_C_DR1VE_ERR "Error Copying filco to C: Driv e " 
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//define COPYDDRIVEERR "Error Copying filoo to D: Drive" 

//define STR BACKUP FAIL "Backup failure: #%ld" 

//d e fin e STRRESTOREFAIL "Restor e failure: ft%\d" 

5 

//define STRLISTFILEERR "Could not open master system file list." 

//defin e STR RESTORE IN PROGRESS "Restore is in progress..." 

//d e fin e STR_BACKUP_1N_PR0GRESS "Backup is in progress..." 

//d e fine ST R_D 1 R_C R E AT EE RR "Target director creation error. #%ld" 

10 //d e fin e STR P RE S SKE Y "Press any key when ready. " 

#defme STR ACCESS DENIED "ERROR Access to drive denied" 

//define ST R M1GR ATEL IST E RR "Could not open th e migration list fil e ." 

//d e fine CLEAR SCREEN printf("\xlb[2J") 

15 

//define SECTOR §45 

////define FO_RE A D_ON LY "rb" 
////define FO WRITE 

20 

//d e fine SYSTEM_BACKUP_LABEL "SYSBACKUP1" 

#defino SYSTEMBACKUPLABELLEN 10 //length of backup lab e l 

//define SYSTEM BACKUP LABEL O "SYS BACKUP" // Version 0 backup lab e l 

25 

Thes e will b e passed in paths 

//define UPGDBKUP FILE LIST "d:\\upgrad e \\upgdbkup.lst" // name of file 

containing 

30 // fil e s to backup 
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tfd o fin o SYSTEMFILELIST M d:\\upgrade\\restore.lst" // namo of filo containing 

// list of fil e s to restore. 

//defin e MIGRATE F1LE_LIST M d:\\upgrade\\migrate.lst" // nam e of file containing 

lint 

5 // of fil e s to migrat e from 

// a pr e vious DCS 300 version. 

±/ 

tfdofino ENDOFFILE "ENDOFF1LE" // should bo last string in .1st fil e 

10 tfdofino MIGRATEZERO "MIGRATE O" // migration info indicator in file 

tfdefine CREATNGEXE "D:\\N EXTGENWCREAT_NG.EXE" 

tfdefin e BACKUP 1- 

tfdofino RESTORE 2 

15 

tfdofin e MINOR 0 

tfdefine REBOOT J- 

tfdofine SHUTDOWN 2 
tfdofine SEVERE 3 

20 

tfd o fin o ALT BOOT DRIVE 'f 

End of fil e upgrad e .h 
25 ** Copyright (c) 1997 Int e rm e c Corp. All rights r e s e rv e d. 
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1.2.9. 



Data Organization 

Changes will be made to the-a_SysMaintitems structure in a ngextm.h file. 
A copy of pseudo-code for an example header definition is included as file 



"ngextrn.h" in the Computer Program Listing Appendix. 



SBMENUITEM SysMaintltems[] ~ 

( ("Configuro Download S e ni o r" , DB S ET TER MDO WN LOAD, 

DB_SET_TERMDOWNLOAD_oh) , 

("Reset to Factory Defaults" , DB_RESET_DEFAULTS, 

: DBRES ETDEF A U LTS_eh ) , 

("Back up System Files" , DB SYSBAK, DB_SYSBAK_oh) , 

("Restore System Files" , DB SYSRSTR, DB_SYSRSTR_eh) , 

("T e rminal License Upgrade" , DB_LlCENSE,DB_LICENSE_eh) , 

("Screen Mapping License Upgrad e " , DB_LICENSE, DB_LICENSE_oh) , 

("Send Transactions" , DB SENDTRAN, DB SENDTRAN eh) , 

("Receiv e Transactions" , DB APPL1CATION, 0), 

("Electronic Softwar e Distribution" , DB ELECT SOFT DISTRIB, 0) , 

("Install Accessories" , DB_INSTALL_ACC, DB_INSTALL_ACC_oh) , 

("Start Host Soooion" , DB_SET_SESSION, DB_SET_SESS!ON_eh) , 

("T e rminal Password Configuration", DLG 222, DLG_222_eh), 

("Controller Command Prompt" , DBS ETCOM MAN DP A S S WO RD, 

DBS ETCOM M AN DP A S S WOR D e h ) , 

("DCS Upgrade Utility", PB_300_UPC_UT1L, OB_300_UPC_UTIL_ef), 

("",0,0)); 
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CLAIMS 



1 . A method for automatically upgrading software on a device, the device having 
a processor, and memory coupled to the processor, wherein the memory stores the software, and 
wherein the device is an automated data collection device, the method comprising: 

coupling the device to a server having an upgrade utility and upgrade software stored 

thereat; 

providing data communication between the device and the server, and the upgrade 
utility determining a configuration or status of the device; and 

upgrading the software of the device by adding additional software to the device. 
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AUTOMATED SOFTWARE UPGRADE UTILITY 



ABSTRACT OF THE DISCLOSURE 

The automated software upgrade utility allows a customer, product supplier or 
software vendor to upgrade the operating system, firmware, applications and data files on any 
product regardless of the product type and characteristics. This upgrade process can be invoked from 
a remote location or via interaction directly with the target device. 

468959 l.DOC 
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